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Preface 



The ibm 709/7090 Input/Output Control System (iocs) is designed to relieve 
programmers of the necessity of writing input and output routines. When using 
the system, a programmer need be concerned only with the content of his infor- 
mation files, and not with the physical processes by which information is read 
and written. He can, if he so chooses, think of each tape reel as consisting of a 
continuous string of words, and each tape drive as having the ability to start and 
stop at any point. During processing, iocs automatically handles label checking 
and preparation, blocking and unblocking of data words, and overlapping of 
processing with input and output. Provision is also made for error detection and 
correction, checkpoint and restart procedures, tape switching, and tape assign- 
ment at execution time. 

These automatic features depend upon the use of the Data Channel Trap; there- 
fore, iocs cannot be used with 709 systems unless they are equipped with this 
device. In addition to the Data Channel Trap, iocs is a participating system under 
ibsys, Basic Monitor, and must be used with it. 

Note that any program which uses iocs to control input/output functions must 
use the system for all its i/o functions and must not use any input/output routines 
other than those of iocs and/or Basic Monitor. 

This manual presents a description of the features of iocs and includes all details 

necessary for using the system. The material covered falls into three categories: 
programming aspects of the system (Part I), a sample problem (Part II), and 
operation of the system (Part III). It is assumed throughout that the reader 
has a thorough knowledge of the 709 or 7090, and of symbolic programming 
techniques. 
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Introduction 



File Description 



Buffer Definition 



The iocs system is composed of two basic parts: one, the Preprocessor, which is 
the initialization routine of the system; and two, iocs itself, which controls 
input/output during the execution of the object program. 

The Preprocessor requires a set of control cards which describe the files iocs is 
to process. It loads iocs into storage, sets up the desired file specifications in the 
format required by iocs using control card information, and initiates loading of 
the object program. Use of the Preprocessor allows variation in the file descrip- 
tion and the system procedure for each computer run. Hence, many different 
kinds of files can be processed by the same program with no change except in the 
file descriptions furnished to the Preprocessor. 

iocs is a set of closed subroutines that automatically overlap input/output and 
processing — the process normally referred to as buffering. In addition, iocs pro- 
vides a scheme for "reading" and "writing" groups of data (any number of ma- 
chine words ) from or onto input/output files, irrespective of the physical arrange- 
ment of data in the file. 

The use of iocs is divided into five distinct functions, as described below, all of 
which are necessary in every program using iocs. Each function is provided for 
by iocs routines or procedures. 



Information necessary for iocs processing of a file must be provided. This in- 
cludes a specification of the i/o unit ( s ) , the file type ( input or output ) , file mode, 
density and labeling conventions. System options such as sequence checking of 
physical tape blocks, calculation and verification of check sums, and multiple reel 
file handling can also be specified. File description is accomplished through the 
use of the Preprocessor file cards ( see page 43 ) . 

iocs requires twelve words — a File Control Block — for control information per- 
taining to each file to be processed using the system. All references to a particular 
file in an object program are made by referring to the first word of the File Con- 
trol Block of that file. 



i/o areas, referred to as buffers, must be defined for use by iocs. The efficiency 
which can be obtained in the overlapping of processing and input/output is 
directly related to the assignment of buffer areas and the size of each individual 
buffer. 



File Initialization 



iocs must be provided with an indication to start reading ahead on an input file, 
or to prepare to overlap writing on an output file. Label checking and prepara- 
tion is also accomplished. The initialization process consists of two steps: 

a. Attachment of the file to previously defined buffer area(s). iocs differs from 
most buffering systems in that the file is attached to buffers rather than buffers 
being attached to the file. In fact, several files will normally be attached to 
the same group of buffer areas, called a Buffer Pool. Because of this feature, 
a buffer within a pool can be used at different times by different files, iocs 
adjusts the number of buffers used for each file according to the relative vol- 
ume of data in the file and the frequency of use. 

b. Opening of a file initiates input/output functions for the file. 



File Processing 



Processing is accomplished by the use of the iocs routines bead, write, and copy. 
With the exception of copy ( which is used to transfer information from an input 
file to an output file), these routines are directed by "commands" which form 
part of the calling sequences for the routines, iocs commands have the same 
format as 709/7090 i/o commands, and their interpretation is quite similar. Each 
command "reads" or "writes" some multiple of machine words from or onto the 
specified file. Optionally, the data may be either transmitted to a working storage 
or located within the buffer area(s) with which the file is associated. Transmis- 
sion of data between the buffers and the input/output units is controlled auto- 
matically by iocs. 



File Closing 



Closing a file provides the indication to iocs that the usage of a particular file is 
to be terminated. For unlabeled files, the wef and rew routines may be used to 
temporarily suspend operation; normal operation will be continued when the file 
is again referred to by a read or write. All i/o activity required for a file between 
the opening and closing of the file, is overlapped with the execution of iocs and 
the object program. 

These functions are described more fully in the following pages. 



Part I: 



Programming Using IOCS 



Section 1 —The Data File 



A Data File is a collection of information stored on some external data recording 
device: iocs is able to handle tape, card, and printed files. The information so 
stored has some logical grouping, each group being called a logical record. A 
logical record may consist of one word, several words, an entire block (one phys- 
ical record of the external storage media, i.e., a card, a tape record, or a line of 
print), more than one block (e.g., all of one block and part of another), or several 
blocks. The form of each logical record may be the same as, or different from, 
the preceding one. The definition of the logical record is expressed implicitly in 
the user's choice of iocs commands and not explicitly by any definition to the 
system. 

In this manual, the term File has three connotations: first, a logical collection of 
data; second, an external device which holds this data; and third, the symbolic 
location of the first word in the File Control Block. In general, when the term 
File is used, the explicit reference intended is the symbolic location of the File 
Control Block. Appendix A contains a detailed description of the File Control 
Block; however, the following explanation will suffice. 

Twelve locations must be reserved for each iocs file, these being reserved by BSS 
instructions such as: 

MASFIL BSS 12 MASTER FILE 

DETFIL BSS 12 DETAIL FILE 



Of these, the first six are used for control information of the file, and the last six 
for labeling information. In no case should any information be loaded into these 
locations by the object program, since they are used by the Preprocessor to store 
information generated from file cards. 
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Section 2 — Buffer and Buffer Pool Definition 



A buffer is an area used for intermediate storage of input/output data. Buffers 
are used by iocs to hold an input block until it can be processed and to hold an 
output block until it can be written. It is analogous to the in-out box found on 
most office desks. The in tray is an input buffer, a place to temporarily hold in- 
formation yet to be processed. The out tray is then an output buffer; it tempo- 
rarily holds information already processed and waiting to be filed. 

A buffer pool is a group of buffers connected so that a file using the pool can use 
any of the available buffers for holding information. Of course, two files cannot 
use the same buffer at the same time. Normally, the size of each buffer in a pool 
will correspond to the size of the blocks in the files using that pool. 

Every buffer pool has two control words which serve to control usage of the 
buffers within the pool. In addition, the first two words of each buffer are control 
words; one is used to keep a record of the status of information within the buffer, 
and the other serves as a machine i/o command when the contents of the buffer 
are to be written, or a block is to be read into the buffer. Thus, if N is the maxi- 
mum number of data words a buffer is to hold, and if the pool is to consist of M 
buffers, the programmer must reserve M(N+2)+2 cells. For example, to re- 
serve space for a pool of eight 30-word buffers, the following symbolic instruction 
could be used: 



POOL 



BSS 



8*30+8*2+2 



The structure of a buffer pool is set up by: 
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This calling sequence defines the area beginning with symbolic location fool as 
a pool of M buffers, each of effective size N, with the first buffer pool control 
word having symbolic location pool. All further references to this pool are speci- 
fied by referring to the symbolic location pool. 

The use of the above sequence requires the area to be a single block. A pool con- 
sisting of buffers scattered within storage can be defined by the use of 
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This sequence causes previously defined pools at symbolic locations poolI and 
pool2, to be considered as one pool; the buffers of each must be the same size. 
poolI is the symbolic location of the first control word of the enlarged pool. 
pool2 cannot subsequently appear in a calling sequence for any iocs routine, 
since it is no longer the location of a buffer pool control word. 



Either of these two defining sequences may be included at any point in a pro- 
gram. However, if any of the buffers involved contain data, this data will be lost. 



Symbolic Location 
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Sample Buffer Pool Construction 
17 18 20 21 
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Buffer Control Words 



When a buffer is being used by a file, the available word locator contains the fol- 
lowing: bits 21-35, the location of the next available word; bits 3-17, the number 
of available words. When a buffer is not in use by any file, the first word con- 
tains the address of another buffer in the pool which is not in use (this is the 
Chain Address.) If there are no more available buffers in the pool, the Chain 
Address will be the location of the first Buffer Pool Control Word. 



Section 3 — File Initialization 



Initialization of files consists of two steps: one, assignment of one or more files 
to use a given buffer pool; and two, opening those files. As a convenience, cer- 
tain files may be "attached" and "opened" in one step; these files are called Im- 
mediate files. There are two other classes of files, Reserve and Internal, which 
must be attached and opened in separate steps. 

Every file must be attached and opened before it can be referenced by any other 
iocs routine. Every file that is to use a given buffer pool must be specified in one 
calling sequence to the attach routine. A group of files to use a certain buffer 
pool is attached by the calling sequence: 
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where 

list is the symbolic location of the list of files ( see page 7 ) , 

FiLECT is the number of files (a decimal number) in the list, and 

pool is the symbolic location of the desired buffer pool. 

This routine establishes a connection between the files and the buffer pool. 



Attachment of Immediate Files 



An Immediate file is a regular input/output file which is to be processed only 
once during the course of the program. It is automatically rewound and opened 
when attached. The number of Immediate files that can be specified in the list 
is dependent upon their type and the number of buffers in the pool. Three types 
of files can be designated to iocs. The three permissible types and their mini- 
mum buffer requirements are as follows: 

1. Input files (I) — each input file requires at least one buffer at all times. 

2. Partial block output files (P) — this type of file permits writing of any num- 

ber of machine words regardless of buffer size. Each type P file requires at 
least one buffer. 

3. Total block output file (T) — this type of output file requires writing of exact 

number of physical blocks each time it is referred to by a write sequence. 
As this type of file does not withhold a buffer from the pool except when 
the file is in use, all files of this type could use the same buffer at different 
times. Thus, all type T files which use one pool require only one buffer. 



A simple example will help clarify the determination of buffer requirements for 
a group of files. Suppose that there are two input files, three partial block output 
files, and four total block output files, that these are all Immediate files, and that 
all are to use the same buffer pool. Then this pool must have at least six buffers: 
two for the type I files, three for the type P files, and one for all four type T files. 
Naturally, the pool may include additional buffers to take advantage of the over- 
lapping possibilities; however, the pool must have at least six buffers for the at- 
tachment of those files to be allowed. 



Attachment of Reserve Files 



A Reserve file is a regular input/output file for which a more complex processing 
is required than is available with an Immediate file. It is neither rewound nor 
opened when attached. Reserve files are specified in groups, although one Re- 
serve Group may consist of only one file. For each Reserve Group in a file list, 
there must be one control word which specifies the number of buffers to be re- 
served for the group and the maximum number of files in the group that are 
going to be open at the same time. The number of buffers specified for a Reserve 
Group must not be less than that obtained by calculating the buffer require- 
ments of the Reserve files which are to be opened simultaneously. The buffer 
requirements for Reserve files are determined in the same way as for Immediate 
files, except that output files require one buffer each. 

As an example, suppose that a group of nine files (two input files, three partial 
block output files, and four total block output files ) are to use one pool and that 
it is known that only one of the input files and one of the type P output files will 
be open at the same time. If these files were all specified as Immediate files as 
shown before, they would require at least six buffers. However, the two input 
files and the three P output files may be formed into a Reserve Group, with the 
control word specifying that the number of files open simultaneously is two ( one 
input, one type P) and that the buffer requirement is two (one for each). Hence, 
the minimum number of buffers required is now only three: two for the Reserve 
Group and one for the four type T ( Immediate ) files. 

A more detailed discussion of Reserve files and their usage is given in Section 7. 



Attachment of Internal Files 



File List 



An Internal file is a file which is kept entirely in core storage and has no i/o 
unit associated with it. From a programming point of view, however, Internal 
files have much the same characteristics as Reserve files; and like them, are speci- 
fied in groups in the file list ( using an Internal Group control word ) . The mini- 
mum buffer requirements for the group are determined in the same way as for 
a Reserve Group. 

A discussion of Internal files and their usage is given in Section 8. 



The list of files which is to be attached to a buffer pool must be of the following 
form, all Immediate files preceding all Reserve and Internal Groups: 
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Immediate files 

Reserve Group Control Word 
- Reserve files 

Internal Group Control Word 
. Internal files 



where 
FILE! are Immediate files, 
FILEiu are Reserve files, 
FILEn are Internal files, 

OPENCT is the maximum of files in the group open at the same time, 
BUFCT is the number of buffers to be reserved for the group, 
SVN is the prefix distinguishing a Reserve Group control word, and 
SIX is the prefix distinguishing an Internal Group control word. 



Opening Reserve Files 



Each Reserve file must be opened before it can be used. It is opened by the call- 
ing sequence 
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where 

FILE is the symbolic location of the first word in the File Control Block for 
the file, and 

the prefix, P, specifies a rewind option: 

P = PZE, rewind before opening 
= MZE, no rewind 
= MON, no rewind, no label action 

A Reserve file may be opened, closed, and reopened as many times as desired, 
whereas an Immediate file may be opened and closed only once. 



Section 4 — File Processing 



The bead and white routines are used to process information files. File process- 
ing by these two routines is controlled by iocs commands which are part of their 
calling sequences. The format of an iocs command is identical to that of a 
machine I/O command, and its interpretation is quite similar, iocs provides two 
methods of processing data. One method is to transmit between the buffers 
and working storage; the other is to process the data within the buffers by deter- 
mining the position of the desired data. In some applications, the logical sim- 
plicity of transmitting is offset by the transmission time required; in others, the 
speed advantage of locating may be counterbalanced by its greater complexity 
or by the lack of available buffer space. Both methods may be useful and desir- 
able in the same data, processing application. 

It should be noted that the meanings of the terms read and write, as used with 
iocs commands, differ from the conventional meanings and are used only to 
imply analogous functions. When used in this way in this manual, the terms 
are enclosed in quotation marks. 



IOCS Commands 



The format of an iocs command is: 
S 2 3 
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This is represented symbolically as: 
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In this representation: 

1. X indicates the type of control, which may be one of the following: 

C— Count Control. The count supplied with these commands specifies the 
number of words to be processed. 

R-Buffer (Physical Block) Control. These commands process all (or the 
remainder ) of a buffer. 

S— Special Count Control. These commands process under count control 
except that special action (described in each case for bead and white 
routines) is taken at the end of a buffer. 

2. Y indicates the function to be performed at the completion of the command. 
Y may be one of the following: 

P— Proceed to the next command. 

T— Terminate the command list. 

D— Terminate the command list and truncate any attached buffer. When 
an input buffer is truncated, the remainder of the block is discarded. 
When an output buffer is truncated, the size of the block written is equal 



10 



to the number of data words in the buffer, which need not be the same 
size as the buffer. 

3. N, if used, specifies that the command is "non-transmitting" (see page 13). 

4. * is used, if appropriate, to specify that the address A is indirect. The effec- 

tive address computation is performed as though all the index registers 
contained zero. 

5. A is the address of the first word processed. If the command specifies trans- 

mission (not an ioxyn type), the address A is supplied by the programmer. 
If the command is non-transmitting, the system supplies the location of the 
next available word in the buffer. Normally, the location replaces the 
address of the command. However, if the non-transmitting command is 
indirectly addressed, the location of the next available word replaces the 
address of the cell specified in the address of the iocs command. 

6. m is the number of words processed. This is normally supplied by the pro- 

grammer; however, if buffer control is used for "reading," the count is 
supplied by the system. 



IOCS Transmitting 
Commands 



The transmitting commands, as the name implies, cause movement of informa- 
tion between buffers and working storage. The execution of each iocs command, 
of course, depends upon the previous commands executed. In general, each file 
is treated as a continuous string of words. For example, if thirteen words were 
"read" by one iocs command, the next command given for the file will start to 
"read" the 14th word, etc. 
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m words are "read" or "written" (transmitted from one or more buffer(s) con- 
nected to the file into consecutive locations starting with A, or from consecutive 
locations beginning with A into the buffer(s) ). Transition from buffer to buffer 
is automatic, iocd, in addition, truncates the processed buffer when transmission 
is complete. (See the Glossary for a definition of "truncate.") 



Buffer Control 

IORP 
IOBT 



$ 



* FOR REMARKS 



LOCATION 

t 6 



_J l_ 



OPERATION ] I ADDRESS, TAG, DECREMENT/COUNT 



I.O.R.Y, 



gjLl 



_J I I I U l_J ' i 



-J I I I 1_ 



-1 I I I 1_ 



-I 1 1 1 1 I I I I 1 I I I I I 1 I I I I I 1_ 



cc 



jj 



READ— Words are "read" ( transmitted from the buffer in use by the file to con- 
secutive locations starting with A) until the end of the buffer is reached. The 
count of the number of words "read" is filled into the iohy count field (m). 



IP 



♦ FOR REMARKS 



OPERATION ] j ADDRESS, TAG, DECREMENT/COUNT 
| i 
I4il»ii« 



LOCATION 



I 
lit 



CO 



I.O.RiY . i I iAi. ,. .m. ■ 



J I l_l 1 L_ 



_1 1 1 I I I I l_ 



-J I I I I I 



_1 — 1 I 1_ 
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Special Count Control 

IOSP 

IOST 



Transfer and 

Continue Command List 



TCH 



Examples 



WRITE— Words are "written" (transmitted from consecutive locations starting 
with A) until the buffer is full or the count (m) is reduced to zero. The com- 
pleted block is then written. 



f 



* FOR REMARKS 



LOCATION 
i It e 



OPERATION 

» 14 



IP.S.Y, 



T 



ADDRESS, TAG, DECREMENT/COUNT 
16 



i A n u CTi 



J — i i — j — i — 1_. 



_l I L_J 1 1 !_ 



-I I 1 I I L_ 



-J — I I I I I I I I I I I I I I I t_ 



READ—m words are "read" into consecutive locations, starting at A, unless the 
end of the buffer is reached. Reading stops when the end of the buffer is reached. 

WRITE— If the block being prepared is capable of holding m additional words, 
transmission occurs to the current buffer. If the block cannot hold m additional 
words, the block is written and the m words are placed in the next buffer. 

* FOR REMARKS 



# 



LOCATION 



OPERATION 

s 14 



L.C.B. 



J L. 



ADDRESS, TAG, DECREMENT/COUNT 
is 



CO 



]A^_ 



_l I I L_J I L — I 1 1 1 L. 



_1 I 1 I l_ 



_J I I 1 I I 1 L- 



„l I 1 I L L_l L. 



The command list continues at location A. The exit from an iocs routine is to 
the location after the first tch command in the list. 

1. To obtain the next logical record from an input file, where the logical rec- 

ord is defined as 26 words, one would give the following I/O command in 
a bead calling sequence: 

IOCT RECORD, , 26 
The logical record would then be "read" into locations record through 

RECORD+25. 

2. To "write" a 12-word logical record from locations alpha through alpha+11, 

the following command may be used: 

IOCT ALPHA, , 12 

3. Logical records may be blocked, one record per physical block, their lengths 

being variable. In this case, the command 

IORT RECORD, , * * 

would "read" all of the next physical block into locations starting at record; 
the length of the block would be placed into the decrement of the com- 
mand. 

4. As a more complex example, such sequences as 



IOCP 
PZE 






can be used to process self-loading variable length records whose first word 
itself is an iocs command to load that record. 
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Non-transmitting 
Commands 



Data can be processed within the buffers by not transmitting the data at all, but 
by locating it instead. Words are "located" in the buffers by using ioxyn com- 
mands. 

In most cases, the ioxyn commands operate exactly like the corresponding ioxy, 
commands except that no words are transmitted. The location of the processed 
words is instead filled into the address of that iocs command. As in example 1 
above, one could use 

IOCTN **,,26 

and iocs would replace ** with the location of that record in an input buffer. 

Clearly, locating words within the buffers adds restrictions to file design and to 
the iocs command sequences. For example, one cannot locate a logical record 
that overlaps a physical block, since the record will not occupy consecutive 
memory cells. The following statements define the allowable locating functions 
and iocs actions: 

1. In "reading," words located by an ioxyn command are considered used when 

the file is next referenced by any iocs routine. Hence, the buffer in which 
the words were located is retained until then. 

2. In "writing," the space located for output words is considered filled when 

the file is next referred to by any iocs routine. Hence, it is not written 
until then. 

3. No single command is allowed to locate words in more than one buffer. 

4. A sequence of commands may locate words in more than one buffer if suf- 

ficient buffers have been allocated to that file by defining a Reserve Group 
which consists of that file only. 

The non-transmitting commands can be used to perform two functions: 

1. Locating, which consists of (1) determining the location in a read buffer of 

the first word of a group (also in some instances, the number of words in 
a group); (2) finding buffer space in which to place information to be 
written. Locating provides the means for processing information in the 
buffers. 

2. Skipping, which is either (1) the omission of information "read" as input, or 

( 2 ) informing iocs of the actual length of an output record already placed 
in the buffer. 

iocs determines whether a non-transmitting command is intended to locate or 
to skip information, in accordance with the end of buffer (eob) switch specified 
in the calling sequence for read and write. If eob = 0, the command is inter- 
preted as a skip, and if eob ¥= 0, it is interpreted as an attempt to locate infor- 
mation. The eob switch is interrogated when the end of a buffer is reached. 



Count Control 

IOCPN 
IOCTN 
IOCDN 



|— * FOR REMARKS 




I LOCATION 

1 \2 « 


7 


OPERATION ] j ADDRESS, TAG, DECREMENT/COUNT 


CO 








> 1 1 1 1 


i i i i i i i < i i i i i. i i i i i i i i i i i i i i i i i i i j 



READ— The next m words of the file are located or skipped, and the location of 
the first of these replaces the ** in the command, iocdn, in addition, sets an 
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Buffer Control 

IORPN 
IORTN 



indicator that will cause the buffer to be truncated the next time the file is 
referred to. 

WRITE— The ** is replaced by the location of the next available position in an 
output buffer in use by the file. It will be assumed that m words have been 
placed into the locations specified, before the next reference to that file, iocdn, 
in addition, will cause the buffer to be written upon the next reference to that 
file. 

* FOR REMARKS 



f 



LOCATION 
I it « 



-1 — L I 



OPERATION ! 



I,0,R.Y,N, 



ADDRESS, TAG, DECREMENT/COUNT 



CO 



_1 I I I I L- 



_i I I L 



_1 U_l I 1 L- 



] 



READ— The location of the next data word from the file replaces the address 
of the command, and the count (m) of the remaining available words is inserted 
into the decrement. The next reference to the file will cause the m located 
words to be bypassed. 



Special Count Control 

IOSPN 
IOSTN 



Examples 



IP 



* FOR REMARKS 



LOCATION 
I it « 



.j i i t_ 



OPERATION 



ipgy.N, , 



T 



ADDRESS, TAG, DECREMENT/ COUNT 
i« 



CO 



i i i i_i i i_ 



-j I I i ■ i i I i_ 



-i I i i_i i i_ 



_i I i I I i_ 



WRITE— The location of the next available position in an output buffer replaces 
** in the ioryn. iocs adjusts the available word locator m words, unless the end 
of the buffer is reached first. The next reference to the file will cause the con- 
tents of the buffer to be written. The user may examine the History Record 
(see page 17) to determine if less than m words can be placed into the buffer. 

* FOR REMARKS 



F 

I LOCATION 
t 



-1 — I L. 



OPERATION j 

i 

» 14 1 15 



I.O.S.Y.N, , j 



ADDRESS, TAG, DECREMENT/COUNT 

16 



CO 



*.* iq 



-I I 1 ' I 



_1 I I I I I 



READ— Words in the buffer are skipped until either m words have been located, 
or the end of the buffer is reached. The address ** is replaced by the location 
of the first of the words located. 

The actual number of words skipped over is reflected in the History Record 
(see page 17). 

WRITE— If the buffer is capable of holding m additional words, the ** is 
replaced by the location of the next available word. Otherwise, the buffer is 
truncated and the location of the first available word of the next buffer replaces 
the **. These commands never adjust the available word locator. Hence, an 
iocyn or ioryn must be executed to advance the locator by the actual number 
of words placed in the buffer when this number is known. 

1. Suppose an entire block from a given input file is to be located. Then the 
command 

IORTN **, ,** 



14 



should be used. When an exit is taken from the bead routine the command 
would have been changed to 

IORTN RECORD, , n 

where record is the location of the next block of the file and n is the length 
of the block. 

2. Suppose the next word of a file is to be placed into the accumulator. Then 

the following command could be given: 

IOCTN* CLAI, , 1 

where clai is the symbolic location of some particular cla instruction. The 
cla would be modified as follows: 

before READ: CLAI CLA ** 

after READ: CLAI CLA LOC 

where loc is the location of the desired word. 

3. Suppose it is desired to locate space in an output buffer in which to create 

a variable length output record. The command 

IOSTN **,,MAX 

will locate an area of max number of words, and the location of that area 
will replace **. The variable length record would now be created by the 
user's own program. Inasmuch as the command was an iosyn (the only 
command which does not advance the available word locator), he must 
subsequently inform iocs of the actual number of words placed in the 
located area by means of a skipping command such as 

IOCTN **, , ACT 

where act is the actual number of words placed in the output buffer, that 
is, the length of the variable length record. 



IOCS Routines 

READ 



Words are transmitted from, or located within, the buffers by the sequence 



r 


-* 


> t- 


OH 


1 Hht 


lAA 


RKS 










1 


LOCATION 
z e 


7 


OPERATION J J ADDRESS, TAG, DECREMENT/COUNT 

' ' / 
8 I4|is!l6 V 








T;S,X. , , . i !R.E,A,D,...4 J 












PZ,E, . 




1 1 

! 1F.LL.E,... ,E,O.B, . 












1 


P.ZiEi i 




! lEiO,F, r , t iE,R,R, , . 
















IO.X.Y, 




i ' 
i i A 














i 


■ '•!! 




i i 
















i i.i i 




i i 
i i 














1 


i i <| 1 




< i 

i i 












, , 


_..! 1 1 1 




i i 
i i 
' • 







IOCS command liBt 



where 

file is the file designation, 
eob is the end of buffer switch, 
eof is the end of file exit, and 
err is the error exit. 

The command list is terminated by the first ioxt, iocd, ioxtn or iocdn command 
encountered. 
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1. eof is the location to which transfer is made when an end of file condition 

occurs. For a labeled file, the condition is recognized from the trailer 
label. For an unlabeled file, any eof mark is recognized as end of file. For 
any file, recognition of the eof mark suspends buffering, so that there is 
no information for the file in any buffer when the eof exit is taken. Buffer- 
ing will be restarted when the next read ( if any ) is given for the file. 

2. err is the location to which transfer is made when any of three types of error 

conditions occur: (a) a redundancy which cannot be corrected; (b) check 
sum error (binary file); and (c) sequence error. The condition is recog- 
nized at the first reference to a buffer in which it occurs. The error en- 
countered may be ignored by continuing to "read" the file. 

3. The end of buffer switch (eob) is interrogated each time the end of a buffer 

is reached, regardless of whether a transmitting or non-transmitting com- 
mand is being executed. 

a. If eob = 0, truncation of the buffer and automatic transition to the 
next one occur; command execution continues without interruption. 

b. If eob t 6 0, all information located will be retained until the next 
reference to the file by any iocs routine. Further, since information 
located by a single iocs command must be in sequential cells, the exe- 
cution of a count command interrupted by the end of buffer condi- 
tion is discontinued, and eob itself is used as the exit of transfer address. 
Otherwise, transition to a new buffer is automatic, and the interpre- 
tation of the command sequence continues, 

Non-transmitting commands may be freely intermixed with transmitting com- 
mands in any command sequence. However, since the eob switch is set on or 
off by each entry into the read or write routines, skipping and locating cannot 
be done by the same sequence. 



WRITE 



Words are transmitted to, or space for words is located within, the buffers by 
the sequence: 



r— * FOR REMARKS 


I LOCATION 
i !z e 


T 


OPERATION \ IA0DRESS, TAG, DECREMENT/COUNT 
i i 

B I4|is!l6 






r.S.X, , , . ! IWRI.T.E. ,.4 \ 






P,Z,E, , , , ! iF,I |L,E,, ,, iEQB ' ■ / 






1 ! / 
LOXiYi i i i iAii i. iT 1 - • 






i i 
i . i i i i i i i 1. 1. i i i ■ i i i • i i i i i 






! ! 
i i. i. • i t i i i i ■ i i i i i 






i i 
i i 
i • i i ' > ■ > ' j 




■ i 


i { 
i t i ,, i i ! i i i i i i i i i i i i i i ■/ 



IOCS command list 



The command list must be terminated by an ioxt, iocd, ioxtn or iocdn com- 
mand. The eob switch functions exactly as described under bead. 
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History Records When the normal exit from the read or write routine occurs, a record of action, 

similar to the record produced by a Store Channel instruction, is supplied, as 
explained below. This "history record" is provided to supply the user with 
information concerning the last iocs command that was executed. The count 
of the remaining words in the buffer can be used to create future iocs com- 
mands or to make other logical decisions. The investigation of the last word 
"read" or "written" may be necessary to determine what the command actually 
did, as in the case of iost in reading, where the count specified may not have 
been satisfied because the end of the buffer was encountered. 

Similarly, iory, in writing, may not write the specified number of words if it 
encounters the end of buffer condition. 

At each exit from the read or write routines the ac will contain the following: 

Bits Contents 

3-17 Number of usable words remaining in the buffer 

which contained the last word "read," or the num- 
ber of unused words in the buffer containing the 
last word "written." 

21-35 1 plus the location of the last word transmitted. 

If an end of buffer, an end of file, a sequence error, a check sum error, or a 
redundancy which cannot be corrected occurs while reading, or an end of buffer 
occurs while writing, the following information is provided: 

Register Bits Contents 

AC 3-17 The 2's complement of the quantity (1 plus the 

location of the command being executed when the 
condition was encountered). 

AC 21-35 1 plus the location of the last word "read" or 

"written." 

MQ . 3-17 The 2's complement of the location of the tsx to 

the read or write routine. 

MQ 21-35 Location of the normal return from the iocs routine. 

In addition, when a redundancy, check sum, or sequence error occurs during 
reading, the prefix of the mq will contain: 

6— if check sum and redundancy errors occurred. 

5— if sequence and redundancy errors occurred. 

4— if a redundancy occurred which could not be corrected. 

2— if a check sum error occurred ( see page 33 ) . 

1— if a sequence error occurred. 

The order in which these errors are detected is: check sum, block sequence, and 
redundancy. If all three checks are being made on a file, the occurrence of only 
a redundancy error is probably a false redundancy error, as the check sum is 
correct; however, the user must realize that check sums are not a foolproof 
check. 
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Transfer of Data 
COPY 



STASH 



When an eob exit occurs during either reading or writing, the prefix of the mq 
will be: 

4— if all available buffers are in use. 

2— if the end of buffer condition was encountered during execution of an iocyn. 

Information which was located by the last i/o command sequence on the input 
file fileI, may be transferred to the output file file2 without actual word trans- 
mission by: 

♦FOR REMARKS 



Tr 



LOCATION 



OPERATION 



T.S.X, 



J I l_J L 



P.Z.E, 



-J I 1_1 L 



ADDRESS, TAG, DECREMENT/COUNT 



CC 



C , QP | Y |,, 4 , 



-j — i_j i i i_ 



-1 I 1—1 L 



Fil L iEil ■. i ■ iFi! L .Ei2i i 



j i i i i i i i i__i i i i_ 



_i i i i i_ 



_i i i i i i i i i i_ 



3 



The rules for information transfer with copy are: 

1. All words in the same buffer with, and preceding, the first word located are 

included in the output. 

2. All words in the same buffer with, and subsequent to, the last word located 

are not included in the output; furthermore, they will behave as if skipped 
when fileI reading is resumed. 

3. If more than two buffers are involved, an intermediate buffer is included in 

the output provided at least one word within it has been located by a non- 
transmitting command. 

Transfer of information between an internal file and some other file, is accom- 
plished by: 

♦ FOR REMARKS 



E 



LOCATION 



_! I l_J L. 



OPERATION ; j ADDRESS, TAG, DECREMENT/COUNT 



LSJk 



a iT.AtSiHi, A . 



_i i i i i i_ 



BZ-E i 



■ ,F,I,L.E ■!.,., .y.T.T^.F.g. 



j i i i i_ 



_i — i ' i * i i — 1_ 



BZ.Ei i , , 1 JNiTiB 



i — i i i i i i i i__i i_ 



i i 
i i 

-I — I — 1 — I — I — I — ! — 1 — I — 1 — I — I 1 I I I I I 1_J 1_ 



I I 1 J I l_l I l_ 



_j — I — i — | — | — | — | — | — 1_ 



Other System Routines 
CLOSE 



where nts is an exception exit (similar to eob). Discussion of the stash 
routine is given in Section 8. 

When activity on a file is to be terminated, the sequence 

* FOR REMARKS 



£ 



LOCATION 



I 

da 



J I L_J L 



OPERATION ] j ADDRESS, TAG, OECREMENT/COUNT 
I i 
i»|ioj le 



CO/ 



T.S.X, 



iC,L,OiS,E,.,4, , 



I lF,IL,E. 



-J — I 1 — I — 1 — L — I L- 



I J — I — 1 — I — 1_ 



_1 I I I 1_ 



-I I I 1_I I ! ! I I I 1 I 1_ 



_l l_J I 1 I I L I I I— 1_ 



will insure that the file does not unnecessarily withhold buffers from use. P deter- 
mines the type of closing as follows: 
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P = PZE 



= PTW 
= MZE 
= MON 



Close with rewind-unload (Note: a file which is rewound 
and unloaded may not again be referenced. ) 

Close with rewind 

Close no rewind 

Close no rewind, no eof mark or trailers written. 



With any type of close, a delay occurs until all i/o activity on the file ceases, 
forcing all buffers in use by the file being closed to be released to the pool. The 
only routine which can produce any further effect on any closed file is an open. 
If the file is an Immediate file, the buffer availability count, which keeps track of 
the number of available buffers in the pool, is increased. If the file is a Reserve 
or Internal file, the count is not increased until its associated Group control 
word appears in a close list. For a regular output file, a close other than the 
mon type, causes writing of (1) an eof mark, a trailer label, and another eof 
mark, if the file is labeled, or (2) an eof mark only, if the file is unlabeled. 



More than one file can be closed at a time by means of the calling sequence: 

* FOR REMARKS 



# 



LOCATION 

I 12 < 



OPERATION J [ADDRESS, TAG, DECREMENT/COUNT 

njislig 



i i 



-J l_J l_ 



TiSiXi i , , t IC,L,QiS iEi . ,4 



j i i i i i_ 



_j L 



P, , ■ , , 



I I 

I I 

-I 1 I I ! I I 1_ 



ILI.S.T F,I .L.E.C.T 



J l I 1 1 l__J I I L-J L_-ly 

J 1 I L_JL I 1 -1_J L .!-._!_ 

J I I I I I I I 1 I 1 I I I 1_1 I I I I 1 L L. 



J I L 



list and filect have the same meaning here as in the calling sequences of the 
attach routine, except that this list may be only a part of the list that was used to 
attach the files. P specifies the rewind options as given above. The same rewind 
option is used for all files in the list to be closed. If a Reserve Group control 
word occurs in the list, the entire group which it controls must also appear. In 
this case, the. buffer availability count is increased by the number of buffers in 
the group. 



Non-data Functions 
WEF 



An end-of-file mark can be written by using the sequence: 

* FOR REMARKS 



G 



LOCATION 



OPERATION ] j ADDRESS, TAG, DECREMENT/COUNT 



i i 



T.S.X. , , , ! IW.E.F. , ,.4. . , 



-J 1 — I 1 — I 1 — I— X ..J__l I I ) 



PiZiF.i 



' 'FiIiLiE.,1, iEiQ.Ti i 



-J — 1 — I — L J — J - I 4 



-I I I I L_ 



J I I 1 1_1 I I 1_ 



_1 I I I I I I I I I 1 l_ 



For an output file, any buffer connected is truncated and the wef executed. If 
end of tape is encountered while writing the tape mark, the end of tape exit 
(eot) is taken. The operation is ignored for an input file, wef will be ignored on 
a labeled file since it would result in an incorrect end of file condition for the 
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output file. Instead, close should be used, as that routine will automatically 
assure proper arrangement of the file. 



REW 



Similarly, a rewind can be caused by: 



r-* FOR REMARKS 






1 LOCATION 

I it t 


T 


OPERATION 

• 14 


I ADDRESS, TAG, DECREMENT/COUNT 
is'ie 


CO 






T.S.X, , , , 


1R,E,W . .4. , , i i i iii i 




P.Z.E. , , , 


1F1I Xj J£ i ■ i i i i i i ■ i ' i i ■ 


1 

1 I i I 1 


i i i i i i 


i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i / 



All buffers in use by the file are released to the pool and the rewind is 
An attempt to rewind a labeled file will be ignored. 



issued. 



BSR 



Backspace of a physical block can be accomplished by: 



fy 



♦ FOR REMARKS 



LOCATION 



OPERATION 
f J* 



T, ax. 



-j i — I — l — 1_ 



ADDRESS, TAG, DECREMENT/COUNT 

i» 



B.8.R.. A 



J 1 l I I I 1 1 1 1 L_ 



_l I 1 1 1 1 — i- 



Fil 1L1E1 » i ■ 1BP1F1 — l 



_l I I I — I L—J » 1 1 L- 



I I i i I I I I l_ 



_J I I I I 1 — I U 




The file is first unbuffered, and an actual machine bsr instruction is then given. 
However, if the bsb would pass over an eof mark, it is suppressed and the be- 
ginning of the file exit (bof) is taken. 



5SF 



Backspace of a specified number of physical files can be accomplished by: 



E 



* FOR REMARKS 



LOCATION 

I It 6 



_! L_J L_J_ 



OPERATION 



TiSiXi 



PZiE, 



-i i i i i i_ 



i ADDRESS, TAG, DECREMENT/COUNT 



JB,S,F.,.4i i 



_1 I I l_. 



JFiIiL i Ei...,CiOiU.N i Ti 



I I L_ J I— 



_1— I — 1 — I — I — 1_ 



I I I i i I I i i I I I I I I I L_l 1 — I — I — 1 1 — 1 1 i— L- 



where count is the number of files to be backspaced. The file is first unbuffered, 
and "count" machine bsf instructions are given, followed by a forward space 
over the last eof mark encountered. However, the forward space is suppressed 
if the tape reaches the rewind position. A count of zero can be used to simply 
unbuffer the file. 
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Section 5 — Labels and Labeled File Procedures 



iocs provides a standard tape labeling system as a specifiable option. The iocs 
labeling procedure provides, as do most labeling procedures, a method for mag- 
netic tape identification and automatic multi-reel file handling. Each reel of tape 
has one "header" record (see page 24 concerning additional header records) 
at the beginning of each reel which serves to identify the reel as belonging to 
a particular file. Each reel also has a "trailer" record which indicates whether 
this is the last reel of a file or not. 

If labeled files are specified, iocs will automatically provide reel switching, file 
identification messages as the file is prepared, and protection for files which are 
to be saved. 



Format of Labeled Tapes 



The format of a labeled tape is as follows: 




BEGINNING 

OF TAPE 

REFLECTIVE 

SPOT 




E TRAILER E 
LABEL 
F F 



"Y 

OPTIONAL 



1. 

2. 

3. 

4. 

5. 
6. 



Labeling is not available for files processed on any on-line card equipment. 

Header labels are always written in the bcd mode and may be in either high 
or low density. 

The eof mark following the header label is in the same density as the label. 

The optional checkpoint record and the eof following it are in the same 

density as the file. 

The file itself may be either high or low density. 

The eof mark, the trailer label, and its eof mark are always written in the 
bcd mode in the same density as the file itself. 



Standard Label Formats 



Blank Reel 



iocs will automatically process 14-word labels of the following formats: 

A temporary header label can be placed on an otherwise blank reel by a card-to- 
tape operation. It should have the following format: 



Word(s) 


Card Column(s) 


Content 


Description 


1 


1-6 




1BLANK 


Label identifier 


2 


7-12 




bXXXXX 


Tape serial number 


3-14 


13-80 




Arbitrary 


Not used 



where: 
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1BLANK serves to identify the reel as a blank reel available for use. 

TAPE SERIAL NUMBER identifies the reel by number. It is assumed that 
each installation has a standard tape serial numbering system. 

Header Label Word(s) BCD Position(s) Content Description 

1 1-6 lHDRbb Label identifier 

2 7-12 bXXXXX Tape serial number 

3 13-18 bXXXXX File serial number 

4 19-24 bXXXXb Reel sequence number 

• 5 25-30 XXbYYY Creation date 

XX -Year 
YYY - Day of year (001-365) 

6 31-36 bbbXXX Retention days 

7 37-38 bX File density 

< — Low 
1 - High 

7 39 X File mode 

0-BCD 
1 — Binary 

7 40 X Block check sum indicator 

( Binary files only ) 

— No check sums 

1 — Check sums present 

7 41 X Block sequence indicator 

(Binary files only) 

— No sequence word appears 

1 — Sequence word is present 

7 42 X Checkpoint record indicator 

— No checkpoint record 

1 — Checkpoint record follows 

label 

8-10 43-60 X. ... X BCD file name 

11-12 61-72 Arbitrary Not used, but reserved for 709/90 

Sort compatibility 

13-14 73-84 Arbitrary Not used 

where: 

TAPE SERIAL NUMBER identifies the serial number of the physical reel. It 
is recommended that the number which externally identifies the reel be used 
as the tape serial number for the label. 

FILE SERIAL NUMBER is the tape serial number of the first reel of the file. 
This number is taken from the label of the first reel on which the output file 
is prepared. 

REEL SEQUENCE NUMBER is the number of the reel within a given file 
( i.e„ the first reel of a file is reel 0001, the second is reel 0002, etc. ). 

CREATION DATE and RETENTION DAYS are the date the file was written 
and the number of days it is to be retained. If an attempt is made to use 
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this reel before (Creation Date + Retention Days) has been reached, iocs 
signals the label error by the message "RETENTION NOT EXPIRED." 



Tbailer Label 



Word(s) 


BCD Positioi 


>i(s) 


Content 


Description 


1 


1- 6 




lEORbb 

or 
lEOFbb 


End of reel trailer 
End of file trailer 


2 


7-12 




bXXXXX 


Number of blocks in file 


3 


13-18 




bXXXXX 


Unit control word 


4-14 


19-84 




Arbitrary 


Not used 



where: 
1EOR will cause tape switching to occur automatically during reading. No 
eof indication is given the user when an eor trailer is encountered. 

1EOF will pause an eof exit from the bead routine If the file is again refer- 
enced, another eof indication is given. 

BLOCK COUNT is the number of data blocks on this reel. This is checked 
for every input reel. If it differs from the number of blocks actually read in, 
a sequence error is given. In this case it should be noted that a sequence 
error for the reel can occur even though each block is not being checked for 
sequence. 

UNIT CONTROL WORD is the location in storage of the first word of the 
Unit Control Block which specifies the tape unit the reel was prepared on, 
and the logical number it was assigned. 

Note: During writing, an eob label is prepared by iocs when the end of a 
reel is encountered. An eof label is prepared when the file is closed. 

Labeling and Label Checking 

Input File Header Label When the file is opened, and at the beginning of each new reel, if it is a multi-reel 

file, the label is checked to ensure that the correct reel is being processed. The 
following conditions must be met for an input label to be valid: 

1. The file serial number given on the file card must agree with the file serial 

number in the label. 

2. The reel sequence number in the label must agree with the reel sequence 

number given on the file card, unless, of course, reel switching has oc- 
curred, in which case iocs will have advanced the reel sequence number 
stored in the File Control Block. 

3. The file name given on the file card must agree with the file name in the 

label. If no file name is given on the file card, this test is bypassed. 

If any of the above checks fails, and the label search option has not been speci- 
fied, the message label errob, input beel invalid, and the label in error are 
printed. A halt will then occur. By sense switch control, the operator may ac- 
cept the reel as valid, in which case he may proceed; otherwise he must mount 
the correct reel to be processed. 

If the label search option has been specified, the message (file name) seabch 
skip list follows is printed, and searching occurs until the correct label is found 
or the operator intervenes. 
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Additional Header Records 
on Input Files 



Input File Trailer Labels 



Output File Header Labels 



The system will automatically bypass all records between the header label and 
the next eof mark. The system provides no automatic way to create these 
records and this feature is provided for compatibility with existing labeling 
schemes. If these records are to be processed, the file should be specified as 
unlabeled; the user can then process the label records as he desires. 

Each labeled file is assumed to be a multi-reel file. The occurrence of an eor 
trailer causes tape switching to the next reel, which is checked before processing 
is continued. The occurrence of an eof trailer or, in fact, any record other than 
an eor trailer where a trailer label is expected, will cause an eof exit to be taken 
from the read routine. The Block Count which appears in every trailer written 
by the system is checked and a sequence error exit is taken if it does not agree 
with the number of blocks "read." 

Every reel upon which a labeled output file is to be prepared must have a label 
written on it. This label may be a Iblank type or a Ihdr type on which ( Crea- 
tion Date + Retention Days ) has been reached. If these conditions are not found, 
either or both of the following messages will be printed: 

LABEL ERROR, OUTPUT REEL INVALID 
LABEL ERROR, RETENTION NOT EXPIRED 

The label is then printed and a stop occurs. Either condition may be ignored 
by the operator, in which case a dummy label is generated, with the file serial 
number*****, and iocs continues. 

Output File Trailer Labels If, during the course of writing an output reel, the eot reflective spot is sensed, 

an eof mark, an eor trailer, and another eof mark will be written. The reel will 
then be rewound (and unloaded if a 7090 is used) and a message will be 
printed to the operator to remove that reel. If the file is assigned two different 
units, reel switching occurs and processing continues. Otherwise, a delay will 
occur until the present reel is removed, and a new labeled blank is mounted. 



Non-Standard Labels 



Non-standard labels may be either a mere arrangement of the standard format 
or an entirely different labeling procedure. If non-standard labeling procedures 
are desired, the iocs labeling routines must be entirely replaced. However, if 
only changes in label formats are desired, the iocs label handling routines will 
still apply. 

If the non-standard labels to be processed adhere to the general iocs labeling 
scheme, non-standard label images may be easily handled by iocs, using differ- 
ent routines to check and prepare label images. For this purpose, iocs allows a 
non-standard label image package to be specified for each file. The location of 
the first cell of this package can be specified in the decrement of each entry in 
the list of files used for the attach routine. If the decrement is zero, standard 
images are assumed^ if it is non-zero, the following procedures will be executed: 

1. All labels, both headers and trailers, will be read and written by the system. 

2. All eof marks associated with labels will also be read and written by the 

system. 

3. The standard label area at symbolic locations iocs + 43 (see page 39) will 

be used; its length is 14 words. 

4. All the system actions and messages will apply. 
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5. At each tsx, index register 2 will contain the 2's complement of the location 

of the first word of the File Control Block for the file being processed. 

6. The contents of all index registers used must be saved and restored. 

Assuming that the non-standard label package begins at symbolic location 
mylbls, then the following actions will occur as indicated: 

1. TSX MYLBLS, 1 To check header label input file 

The routine must return by means of: TRA 1, 1 if label is correct 

TRA 2, 1 if the input label 
is invalid 

Bit 35 of the 7th word of the label area must be 1 
upon either return if a checkpoint record is to 
be skipped. 

2. TSX MYLBLS + 1, 1 To check trailer label, input file 

Return must always be: TRA 1, 1 
Upon return, the sign of the mq must be: 

+ if eor; tape switching will occur 

— if eof; an eof exit will be taken 

3. TSX MYLBLS + 2, 1 To check label on tapes to be used for output 

Return must be: TRA 1, 1 if the reel may be used 

TRA 2, 1 if ( creation date + retention days ) 

has not been reached 
TRA 3, 1 if it is not possible to use the reel 

4. TSX MYLBLS + 3, 1 To prepare output trailer label 

Return must always be: TRA 1, 1 

Upon return, bits p, 1-35 of the ac must contain: 

lEOKbb if an eor trailer is to be prepared 
lEOFbb if an eof trailer is to be prepared. 

5. TSX MYLBLS + 4, 1 To prepare output header label 

Return is: TRA 1, 1 
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Section 6— Unlabeled File Procedures 



Although the handling of labeled files is entirely automatic, iocs is equally 
capable of processing unlabeled files. The difference is that multi-reel file han- 
dling is only semi-automatic for unlabeled files, since the occurrence of the eof 
mark can have several meanings. 



Single-Reel Unlabeled Files 



An unlabeled file which is contained on one reel of tape may have any number 
of eof marks. The detection, during reading, of each eof mark temporarily 
suspends buffering on that reel. When an eof is detected by the read routine, 
the eof exit is given. If the file is again referred to by a read calling sequence, 
buffering will continue until the next eof mark is encountered. It is the pro- 
grammer's responsibility, in this case, to determine which eof mark signifies the 
actual end of the file. No reel switching is possible for input files of this type. 
If eot is encountered while writing a supposedly single reel unlabeled file, a reel 
switch will occur and processing will continue. In some instances, such as peri- 
pheral output files, no harm occurs from this action. However, if the file is to be 
processed by iocs at a later time, the file is not describable. (It is a multiple- 
reel file with more than one eof mark on a reel, a situation which is not 
allowable. ) 



Multi-Reel Unlabeled Files 



Multi-File Reels 



A multi-reel unlabeled file may have only one eof mark— that which signifies the 
end of the reel. This eof mark is written automatically when the eot reflective 
spot is sensed while writing. Reel switching occurs after the eof is written. 
When an eof mark is detected while reading a multi-reel unlabeled file, all 
buffering is suspended until the eof record is reached. An eof exit is given once 
per reel for each eof encountered and if the file is again referenced by a read 
operation, reel switching will occur and buffering will be resumed. For this 
type of file, the user must have a recognizable data record to indicate that the 
end of the file has been reached. 



Several files which appear on the same reel may be processed automatically by 
closing each processed file without rewinding and then opening the subsequent 
file, iocs does not automatically rewind any reel except at tape switching. Hence, 
a single reel may contain several complete files and the first portion of a multi- 
reel file. Labeled and unlabeled files may be mixed upon the reel, provided 
some precautions are observed in the usage of iocs routines. For example, the 
bsf routine with a count greater than 1, may not result in positioning at the 
beginning of data of a given file because of the occurrence of eof marks for 
labels, trailers, and checkpoint records. It is also unlikely that open with label 
search would find the correct file. 
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Section 7 — Use of the Reserve Group Option 



An unusual feature of iocs is that the programmer does not normally assign a 
fixed set of buffers for the exclusive use of any file. This can be done by attach- 
ing only a single file to a pool, but at the almost certain sacrifice of efficiency in 
time, space, or both. The attachment of more than one file to a pool, however, 
does create a problem: the system must ensure that any file using a pool will be 
able to obtain at least one buffer when needed, since otherwise reading or writing 
could not be accomplished. In iocs, control is exercised by means of the Buffer 
Availability Count (see page 75), and for most data processing applications this 
is sufficient. 

Sometimes, however, situations occur for which more control is either necessary 
or desirable. The Reserve Group option is the programmer's principal tool for 
these "unusual" cases; and an understanding of its use is necessary to obtain 
maximum utility of iocs. The paragraphs which follow discuss three situations 
and illustrate the use of the Reserve Group in handling them. 



Deferred Opening of a File 



If a file is to be used late in a program, or perhaps not at all, depending upon the 
flow, then placing it in a Reserve Group will generally benefit the program, since 
buffer space will be free until needed by the file. For example, if fileI and 
file2 are the respective locations of the File Control Blocks for two files which 
will never be used at the same time, attaching them to a pool as the Reserve 
Group: 



p* FOR REMARKS 



IP 



LOCATION 



_!_ 



_l_ 



' ' ■ 



OPERATION J j ADDRESS, TAO, DECREMENT/COUNT 



j i 

I4|I B|W 



S.V.N, . , , j |l„ ~ 



P.ZE, ... I IF.I .L.E.I 



i i i 



j i i i 



P.ZE, 



i i l 



IF,I,L,E,2 



■ i 



-i—i i—i ■ ■ ' 



-i — i — i i 



will withhold only one buffer from the general pool availability, whereas attach- 
ing them as Immediate files would withhold two. 




■ ■ ' ■ i 



Using a File for Both Input and Output 



In some instances, a file is used both as input and as output. It is not unusual, 
for example, to create an intermediate tape as output from one phase of a prob- 
lem, and then to use this tape as input to some later phase. A simple way to 
handle this is to refer to the file using separate File Control Blocks for the input 
and output phases. That is, identical blocks should appear at locations in and 
out, except that in is described as an input file and out as an output file. The 
file can then be attached as a Reserve Group, as follows: 

* FOR REMARKS 



t 



LOCATION 



I 



I I I 



-1 1—1 1_ 



I I I I I 



-1 1—1 I L 



OPERATION ] j ADDRESS, TAG, DECREMENT/COUNT 



j ! 

I4|l»| l8 



I I 



S.V.N. ... I II 1. . 



—i i_ 



EZJ2 



J — I I I L 



ILK 



-I 1— 1 — I 1—1 L. 



P.Z.E, , . , ! jQ.U.T, 



-1 — I , I I l_l L_! I 1_ 



-1 I I I I l_ 



-J— 1 1_ 



_J L_J l_ 

_1 l_J l_ 



_1 I ' ■ 



I I L 
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The out file would be opened and used during any output phase, while the in 
would be closed; the reverse would apply during an input phase. 



Using More Than One Buffer for a File 



If a file is being used in such a way as to withhold more than one buffer at a 
time from a pool, then it must be treated as a Reserve Group (by itself) and 
the buffer requirements expressed by a sufficiently high count. 

Suppose, for example, that a file, whose File Control Block is located at file, has 
been produced by a card-to-tape operation. Suppose, further, that five cards of 
this file are to be processed at a time, and that the information from these five 
cards must be retained during the processing (sorting is such an example). A 
convenient way of reading the file is by: 



r r 


-* FOR RE» 


ilA 


RKS 




































I 
i 


LOCATION 
2 6 


7 


OPERATION | | ADDRESS, TAG, DECREMENT/COUNT CO 1 
i i 

8 14 lis! 16 / 




I I I I 




T.S.X. , . , i iR,E.AEl.,4 \ 




1 I I 1 


P ,3E, , , 


! IF.I.L.E E,0 


^ 






























1 1 J 1 


p,z;e , , 


! !E,0,F E 


RR 
































i i i I 


I.QREN,* 


! h,l *■* 




































1 I I 1 


I.QRP.N, * 


! R2 *.* 
































/ 




i i i i 


I,0,R,P,N* 


i i 

i RJ * * 
i f* i° if ,• i i 
































\ 




i i i I 


I.O.R.P.N,* 


i i 

1 OR 4 * * 
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J 




III I 


I.O.RPN,* 


1 iRB * * 
1 i°i* 
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In this head usage, since eob ¥= 0, the non-transmitting iocs commands locate 
the initial address of each card buffer. Since indirect addressing is used, these 
addresses are placed by iocs into the addresses of the words located at r1, b2, 
r3, b4, and b5, respectively. If, then, these words were 

* FOR REMARKS 



t 



LOCATION 



5l 



OPERATION J j ADDRESS, TAG, DECREMENT/COUNT 
I i 
t4Jia|i» 



Ax;c, 



I l l L_L 



*.* 



,-ui 



J — I — I I I J I u 



-1 — I — I — l—l l_ 



_I — I — ! — ! I I I * i ■ 



-J I I I I 1_ 



-1 — 1 I I I I 1_J 1_1 1 I i ' 



then the Nth word in any of the buffers can be referenced by first executing the 
appropriate instruction at location Ri, and then executing: 



Tr 



* FOR REMARKS 



LOCATION 



OPERATION | '.ADDRESS, TAG, DECREMENT/COUNT 

I i 
iliiBJie 

' ' — — — ^^m ^ ^— — — — - 



o , p, , 



i IN. ,4, , . 



i i 
■ i 

_!_! I I i l_ 



_1 I I 1_J I I, „l. 



_l I I 1 I L_l L_ 



It is clear that this procedure will require the use of no fewer than five buffers 
by the file at all times. Actually, iocs would try to use at least ten, for at each 
entry to the bead routine, when the five buffers just processed are released to the 
pool, minimum delay (that is, maximum overlap) occurs if the next five have 
already been filled and are waiting to be located. If, however, ten are not 
available— either because there are not ten in the pool, or because other files 
are using them— the system can still operate properly as long as there are at least 
five available to the file. This condition can be guaranteed only by an attachment 
of the form: 
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r— * FOR REMARKS 






1 LOCATION 
1 |2 6 


7 


OPERATION | {ADDRESS, TAG, DECREMENT/COUNT 
a I4||»J|6 


ca 






S.V.N. , , . ! 








P.Z.E. , , . ! 






1 

l i i i ■ 


i i i i i i i 


' i i i i i i ' i i < i ' i i i il 



with m not less than 5. 

Finally, it should be noted that if the programmer had erred and written: 



|— * FOR REMARKS 






1 LOCATION 
I U 6 


7 


operation | | address, tag, decrement/count 
• mIisIis 


cd 






S.V.N. , . . ! 








P.Z.E, , . . i 






1 



ii 


i i i i i i i i i i i i i i i i i i i i ■ i 


■ i i i i i i i i i 



then the eob exit would have been taken after execution of the third iobjpn*, and 
this would occur even if, at that particular time, a buffer were available in the 
pool for use by another file, iocs control forces this action, since otherwise some 
file might later be unable to obtain a buffer. In this usage, eob is to be inter- 
preted as "end-of-available-buffers." 
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Section 8 — Use of the Internal Group 



An Internal Group is a special type of Reserve Group. Its files are retained en- 
tirely in core storage ( in buffers within the pool allocated to the group ) and are 
never, as such, written onto, or read from, an i/o unit. 

The programmer, however, processes these files in the same way as a regular 
file. The full power of the head and white routines is available, and their usage 
is the same. Because of the special nature of Internal files, some system routines 
have no meaning (and so do not apply), while others are interpreted in a manner 
consistent with this nature. 

Use of the Internal file can result in increased efficiency for some applications. 
In others, such as storage allocation and searching problems which arise in the 
generation and manipulation of variable length tables, it can prove of substan- 
tial benefit. 



Opening an Internal File 



An Internal file, like a Reserve file, is activated by the open routine. Unlike a 
regular file, however, the open is also used to indicate the type of processing 
desired. In the sequence 



♦ FOR REMARKS 



I LOCATION 

* 



J 1 l l 1_ 



OPERATION ] [ADDRESS, TAG, DECREMENT/COUNT 



TSJC, , , , i iOI>,E,N , .A, 



i t 
i—i — i — i iF|I|T^E| u , | i . i iiii 



-j — i — i — i i ■ i 



-J l_i_l_J — !_J — 1 1 1 — 1 1_1 1 I I I 1 i 



the interpretation of P is: 

P = PZE The file is prepared for writing, and any information al- 

ready in the file is discarded. This is analogous to open- 
ing a regular output file with rewind. 

= MZE The file is prepared for writing, and any information al- 

ready within it is retained. This is analogous to open- 
ing a regular output file without rewind. 

= PON The file is prepared for reading, making any information 

within it available. During the course of using the read 
routine, processed buffers are released to the pool exactly 
as for a regular file. This mode of operation can be 
thought of as a "destructive" read. 

= MON The file is prepared for reading, making any information 

within it available. However, in this case, processed buf- 
fers are never returned to the pool. They are retained 
by the file, and may be reprocessed on a later pass through 
it. This mode of operation can be thought of as a "regen- 
erative" read. 
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Closing an Internal File 



The close routine is used to terminate the current type of processing of an 
Internal file. In the sequence; 



fy 



* FOR REMARKS 



LOCATION 



OPERATION ] 
( 
a 14 1 la 



ADDRESS, TAG, DECREMENT/COUNT 

16 . 



T , S , X , 



J i_i L 



C.LiOiS. E, ,,4, , i , 



j... i l a 



_ji i j i_ 



E_ 



F.I.LE, 



-J 1 L,_l I — 1 L_ J 



_A. J— 
„1- X- 



-J I I I !_ 



I I I I I I I l_ 



the interpretation of P is: 

P = PZE All buffers in use by the file are released to the pool, and 

the file may not again be referenced. This is a "destruc- 
tive" close analogous to a rewind and unload for a regular 
file. 

= MZE .. Reorganizes the structure of the file, causing it to appear 

as if it had just been written. The file may be opened 
again (with any of the available options). This may be 
thought of as a "regenerative" close. 



Processing an Internal File 



READ 
WRITE 



STASH 



The only difference in the use of bead and write for an internal file is in the 
interpretation of the meaning of the eob exit: 

1. The eob exit will occur on writing when an additional buffer is needed and 

all the buffers allotted to the Internal Group are in use. In effect, this is 
an end of buffers exit. 

2. The eob switch on reading works exactly as for a regular file, except that the 

end of buffers exit cannot occur. For an Internal file in read status, end 
of buffers and eof are synonymous. 

During the course of processing, it is often desirable to transfer information be- 
tween an Internal file and some other file. This is accomplished by means of the 
special copy routine, stash. The sequence: 



|— * FOR REMARKS 
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T 


OPERATION 
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j ADDRESS, TAG, DECREMENT/COUNT 
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t 
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effects the transfer by means of buffer reassignment from fileI to file2, pro- 
vided both files are attached to the same buffer pool, nts is a location to which 
return will be made for "Nothing To Stash" or "Noplace To Stash" conditions, 
under circumstances which are described below. 
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Four cases are permitted in the use of the stash routine. These cases, and the 
iocs actions involved, are: 

1. fileI is an internal output; file2 is a regular output. 

The initial buffer is deleted from the chain of fileI buffers, and appended 
to file2. The nts return will occur if there is no buffer in the fileI chain 
which has been completely processed. This usage allows the programmer 
to provide a regular output file for "overflow" of the Internal Group area. 

2. fileI is a regular input; file2 is an internal output. 

As in the case of the copy routine, the buffer or buffers which contain in- 
formation which was located by the last read sequence on fileI, are ap- 
pended to the file2 buffer chain. The nts return occurs if during the re- 
assignment, the Internal Group is about to overflow its full quota of buffers 
(as indicated by bufct in the Internal Group control word). This usage 
allows the programmer, for example, to set aside some data from fileI 
for later processing, without the necessity of again processing the entire 
file. 

3. fileI is an internal input; file2 is a regular output. 

For this usage, the stash routine behaves exactly like the copy routine. It 
should be noted that buffers will be removed from the fileI chain and 
hence are lost to fileI, even if the "regenerative" read mode is in use. 
The nts return cannot occur. 

4. fileI is an internal input; file2 is an internal output. 

This functions exactly like case 2. However, buffers will be removed from 
the fileI chain even if the "regenerative" read mode is in use. The nts 
return occurs if during the reassignment, the Internal Group to which file2 
belongs is about to overflow its full quota of buffers. Note that even though 
fileI and file2 must be attached to the same pool, they need not belong 
to the same Internal Group. 
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Section 9— Block Sequence Numbers and Check Sums 



Every File Control Block carries a block sequence number for the current reel 
of the file. On a labeled file, this sequence number is always written in a trailer 
label at the end of each reel and checked when it is read. 

In addition, for a binary file, a block sequence word can be appended to the 
end of each block, regardless of whether the file is labeled or unlabeled. This 
word contains the sequence number of the block in its address and may also con- 
tain an 18-bit folded check sum of the block in the left half of the word. The 
check sum is formed by computing a logical sum of the entire data in a block, 
excluding its block sequence word, and then logically adding the left and right 
halves of this sum. This computation requires the execution of at least two in- 
structions for each data word, and hence may be costly to the program. On 
the other hand, forming and checking a block sequence number is accom- 
plished in a few programming steps for each block, and it is quite helpful in 
detecting certain machine malfunctions, such as a tape shift-register trouble. 

Note that in order for a block sequence word to be generated and checked, each 
buffer requires an additional word, which must be accounted for when the buffer 
pool is defined. However, the generation and checking are accomplished inter- 
nally and this extra word is transparent to the processing of data. 
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Section 10 — Checkpoint and Restart 



A checkpoint is a reference point to which a program may return for restart. 
Restart may be necessitated for various reasons: machine failure, operator error, 
erroneous data, interruption of a program by an operator, etc. In iocs, the check- 
point record contains all the necessary information for restart. 

A checkpoint may be initiated by one of three conditions: beginning of reel on 
a labeled file, execution of the checkpoint routine by a program, and operator 
intervention by the use of a sense switch assigned for this purpose. In the first 
case, a checkpoint is written either after the label on an output tape or on the 
checkpoint file depending on which was specified in the file card. In the latter 
two cases, the checkpoint is always written on the checkpoint file. 

The checkpoint routine saves the contents of all index registers, and sense indi- 
cator and sense light conditions, and sense switch settings, forces cessation of all 
input/output activity, prints out a checkpoint identification together with a 
restart code, and writes a checkpoint record of two blocks followed by an eof 
mark. The first block contains information about the use of files and the neces- 
sary data for tape repositioning. The second block contains the contents of all of 
core storage and the conditions of the registers and indicators. The checkpoint 
identification is a sequence number and it is increased by 1 every time a check- 
point record is written. 

A checkpoint file should not be attached to any buffer pool, as it uses no buffers. 
However, it must be opened, rocs records which was the last checkpoint file 
opened and always uses that as the current checkpoint file. 

A checkpoint can be written by the programmer by using the calling sequence: 



IP 



* FOR REMARKS 



LOCATION 



OPERATION | I ADDRESS, TAG, DECREMENT/COUNT 
j i 



SgJL^. , I jC,K?,T,„4 



i i 

-> — "— ' — I — I—! — 1 — I — I — I — I— 1 — 1—1 I I I I I 



If the checkpoint routine is entered, but the checkpoint file has not been specified 
by the use of a file card, or been opened, immediate return is made to the 
program. 

Restart is strictly an operator procedure and cannot be initiated by a program. 
The restart routine uses the information in the checkpoint record to print mes- 
sages to assist an operator in mounting tapes and setting sense switches, to 
reposition tapes, and to restore the core storage, index registers, sense indicator 
and sense lights to their status when the checkpoint was taken. The execution of 
the program is resumed from the point in the program at which the checkpoint 
record, used for the restart, was written. 
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Section 11— Density and Mode Conventions 



Density 



Mode 



If a reel is to be involved in restart, iocs allows a tape density change, if any, 
only after the first eof mark on the reel. The reason for this restriction is that 
the restart routine must know the density of every block and eof mark to be 
skipped over in the process of tape positioning. If an arbitrary number of density 
changes is to be permitted, every change would have to be indicated by some 
means; this would require a rigid tape format. 

Tape densities of a file and its header label are specified by a file card and are 
stored in a File Control Block. The density of a checkpoint record on a labeled 
file is the same as that of the main body of the file. In the case of a multi-file 
reel, a density change is permitted only after the header label of the first file; the 
remainder of the reel must be the same density because of the above restriction. 

A standard density option is provided for labeled files. If this option is indi- 
cated on the file card, the density of the label will be that specified for the file. 
Furthermore, when an output file is prepared, the density of the label on the 
reel to be checked for validity is always the same, low or high according to in- 
stallation choice. It should be emphasized that if the standard option is not used, 
the density of the label of the blank reel must agree with that specified for the 
label of the file to be written. 

The bsf routine cannot be used on a reel with mixed densities, since difficulty 
will be encountered in backspacing over files of different densities; nor can it 
be used to reposition in front of the data of a labeled file for which label and 
file have different densities. 

It is strongly recommended that density changes be avoided. 



Normally, the body of a file will contain information recorded in only one mode, 
binary or bcd. However, iocs is capable of processing a mixed mode file whose 
blocks contain the standard look-ahead words as described in the ibm 7090 Op- 
erators Guide (Form A22-6535). The user need only describe this file as a mixed 
mode file on the Preprocessor file card and iocs will determine the mode in 
which to read each block, although no indication will be given the user as to 
what that mode was. 

A mixed mode output file can be written, but it is the user's responsibility to 
place the proper look-ahead words into the buffer, iocs will always write the 
first block in the mode specified on the file card. 
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Section 12— Printing Messages On-Line 



ioex provides a routine which facilitates printing messages on the Channel A 
printer, with editorial flexibility achieved by (a) composing the line from any 
number of designated parts, and (b) providing for sense printer instructions 
between lines. 

The calling sequence is: 
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The quantities n, p, l, t, m, and spr are parameters which serve the following 
purposes: 

1. n is the number of words in the calling sequence ( following this one ) . 

2. p, l, t, m. The m words (of 6 bcd characters each) beginning at location 

l, t are converted to Hollerith and placed in the line image for printing. 
If p = pze, the image is taken to be complete and the line is printed. If 
p = mze, this line is considered incomplete, and the l, t and m in the next 
word of the calling sequence are used in order to continue building the 
image. 

3. spe. If p = pze, then the sense exit spr is activated after the line is printed. 

(An spr appearing in a word with p — mze is ignored). Activation of an 
exit before printing the first line can be accomplished by inserting into the 
calling sequence: 



i— * FOR REMARKS 




1 LOCATION 
mi e 


7 


OPERATION J | ADDRESS, TAG, DECREMENT/COUNT 

s ujislia 


CO\ 








i i ■ i i 


• i i i i i 1 ' i i i i i ■ i i i , i i t i i i , i r I \ 



This will print a blank line, followed by activation of the sense printer 
hub, spr. 

Suppose, for example, that in three consecutive words at location l1 we 
have the bcd text 



THIS IS ONE 



and at location l2 we have 



SAMPLE 
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t 



Then, assuming the share standard sense exit hubs, the sequence 

* FOR REMARKS 



LOCATION 
» 6 



OPERATION 
a 14 



TSX^ 



EZ£l 



P.Z.E, 



M.Z.E, 



RZiEi 



ADDRESS, TAG, DECREMENT/COUNT 
ic 



aWH.,,4, 



1 . , . 1 5, 1 ,2 , 



L ' 1 " "> 3 ' 



L,2 i» i ■ il i"t"i5 



j i i ii 

j i_i i 

-J 1 ' I : 



J I.,. I 



d 



would result in 

( 1 ) eject to a new page; 

(2) the line 

THIS IS ONE SAMPLE 

(3) a double space. 
On the other hand, the sequence 



i— * FOR REMARKS 


1 LOCATION 
1 12 6 


7 


OPERATION j (ADDRESS, TAG, DECREMENT/COUNT cd 
e I4|Ib'|6 / 






TS.X. , , , i iMWR,.,4 , , , , ,_lJ 




?AE, , , , 1 ,2, |,|||| Ill 111 1 1 _i 1 .L..L._L_1_ 1 J 




EZE, i,ii iLil 3 i i i i i ■ i i , , ■ , , i i i i , i i i / 




EZEi ii,! !L,2,.i f ,li+,5,l l 2, l|, .l , i , ■/ 
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would result in 

( 1 ) the two lines 

THIS IS ONE 
SAMPLE 

( 2 ) followed by a page eject. 

The entry mwh is directed to the communication vector of ioex in Basic 
Monitor, mwr points to ioex + 4. (See Basic Monitor bulletin entitled: 
IBM 7090 Operating Systems: Basic Monitor (ibsysj.j 



37 



Section 13 — Program Preparation 



Storage Conventions 



From a programmer's point of view, iocs is a collection of subroutines which 
perform a variety of file processing functions. In order to furnish a convenient 
standard procedure for using these subroutines, iocs has been incorporated into 
an operating package. 

Briefly described, the operation of the system for any job consists of the following 
steps: 

1. The iocs subroutines and the Preprocessor are loaded from a Basic Monitor 

System Tape. 

2. The Preprocessor reads a set of control cards from the Program Input Unit, 

sysini, and creates, in storage, a group of File Control Blocks. 

3. A loading sequence is initiated for the Program Input Unit to call the object 

program. 



The iocs subroutines are assembled as a group and are located in core storage 
immediately following ioex of ibsys, Basic Monitor. All of storage beyond the 
end of iocs is available for the object program, together with its working storage, 
buffers, and the File Control Blocks. 



References to System Subroutines 



Within his program, a programmer must define the transfer points to 
iocs subroutines which he uses. These transfer points are located relative 
origin of iocs itself: 



those 
to the 



* FOR REMARKS 



A;TiTiAiQH 
CJLiOSiEi 



I LOCATION 

i 
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T- 



DlEFI N.E 



JiO.I.N, 



OPEN 



RlEAD, 



WfiI , T , E L 



R!E , w , 



m& , L 



B|S^ 



BS,F, 



qtt.p?, 



SITAS.H, 



^W3 , ■ 



J I I I I — 



EQ.TJ , i 
E,Q,U, . 



OPERATION 



Eft ill i 



E.Q.U, 



EQ.U, 



E&Ji 



E&Ul. 



E^IL 



E^U, 



my,. 



my^ 



E.Q.IJ. , 



E.Q U . ,_ 



5M^ 



E.QU, 



SQU. 



ADDRESS, TAG, DECREMENT/COUNT 






I ,OC S +.4 



i,o,c,s,+ ,6, 



I iO,C,S,+.8i 



l&P. s , + , i , » 



I ,QC,S ; - hl,4 



LQ&&+J& 



I.QgB,H;l,8 



I ,0,0,8, +.2,0 



1 ,0,0,8,+ , 2,2 



I.O.QS, +.2,6 



IfiSAA*! 



I,Q,C,S,+,3,0 



1,0,0,8, +.38 
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_i_..J l 1 L 
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,-L -J I ...J... L...I 

a^i-.-.i— -1 1 1 



_l_j._j 1 i_.-i l-.j ... L .1.. l i a 



_J I I L- 



-X_i_J__J L__L.X._L- 1—1- 



_l I 1_ L_ . i — 1 _l 1 



.J.- 1....J 
l_..l 



The actual location corresponding to symbolic location iocs may vary from 
installation to installation. For any installation, however, this location and those 
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defined relative to it, as shown above, can be expected to remain fixed, even when 
modifications are made to the iocs system itself. 

In addition to the above subroutine transfer points, certain other quantities which 
may be of interest to the programmer are located near the beginning of iocs: 



Location 
Symbol 



DATE 



JOBID 



LAREA 



LFLBLK 



XEOB 
XEOF 



Position 
Relative to 
Location IOCS 



Contents 



IOCS + 39 



IOCS + 401 

to 

IOCS + 42J 
IOCS + 431 

to 

IOCS + 56J 
IOCS + 57 



CPFILE 


IOCS +58 


CPSEQ 


IOCS + 59 


LTSX 


IOCS + 60 



IOCS + 61 
IOCS + 62 



System date. The internal mode is BCD, 
and the cell is of the form YYbXXX, 
where 

YY = Year 

XXX = Day of the year (001-365) 

Job name 



Label area ( 14 words ) 

This word defines the origin and length of 
the File Block prepared by the Preproc- 
essor. It is of the form 

MZE A, , B 
where 

A= File Block origin 
B = File Block length 

Address: 
Current checkpoint file in use 

1 + sequence number of last checkpoint 
written 

Prefix: 

— No error 

1 — Block sequencing error 

2 — Check sum error 

4 — End of buffer error 
Decrement: 

2's complement of the quantity ( 1 + the 
location of the IOCS command on 
which the error, if any, occurred) 
Address: 
2's complement of the location of the 
TSX instruction which last entered 
IOCS 

Decrement: 
Location of the EOB exit 

Address: 
Location of the EOF exit 
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Location 
Symbol 



Position 

Relative to 

Location IOCS 



Contents 



XERR 



LTRAD 



TRANS 



WDCT 



IRS 



SENSE 
FCW 



IOCS + 63 Decrement: 

Location of the error exit 
IOCS + 64 The last history word loaded into the AC: 

Prefix: 
PZE 
Decrement: 

1 + the location of the last word proc- 
essed 
Address: 

Count of words remaining in the last 
buffer used 
IOCS + 65 Address: 

Location of the first word processed by 
the last IOCS command 
IOCS + 66 Decrement: 

Word count of last IOCS command ex- 
ecuted 
IOCS + 67 Address: 

Contents of index register 2 at last entry 
to IOCS 
Decrement: 
Contents of index register 1 at last entry 
to IOCS 
IOCS + 68 Contents of Sense Indicators at last entry 

to IOCS. 
IOCS + 69 Address: 

If = 0, IOCS was not in control 

If ¥= 0, this is the current file being used 



Completed Program Return Point 



File Control Blocks 



At the completion of a program, the standard action is a transfer to symbolic 
location IOCS. The system will then print a message indicating that the job has 
been completed, will set any reserve unit status for intersystem use, and will 
resume scanning for IOCS control cards on the Basic Monitor Input Unit. 



Each iocs subroutine calling sequence permits reference to one or more files. 
A file is specified in a calling sequence by giving the first location of the twelve 
word File Control Block for that file. A File Control Block contains certain fixed 
information about the file, such as the file type (input, output, or checkpoint), 
the recording mode and density, labeling conventions and the file name, as well 
as the assignment of input/output units. Other portions of this block are used by 
iocs to post the current status and activity of the file. 
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File Block 



Unit Control Blocks 



The File Control Blocks required by a program are normally generated by the 
Preprocessor, just prior to execution of the program, from a set of control cards 
supplied with the program. In his program, the programmer need only provide 
the set of block reservations defining the files for program reference: 



i— * FOR REMARKS 


1 LOCATION 
I 12 « 


7 


OPERATION | [ADDRESS, TAG, DECREMENT/COUNT CO^ 

S I4|l»!l6 / 


f! i,l,e,i. 






Fl LL.E2, 
















Fil,L,EK, 


BiSiS, i i i i ili2 i i i i i i t il 





i i i i i i i i i i i i i i i i i i i i i \ 



The File Control Block reservations should be programmed, as shown above, to 
occupy a single storage area consisting of a succession of twelve word blocks. 
This area will be referred to as the File Block. It is, then, possible to assign to 
each of the File Control Blocks, in order, the numbers 1, 2, . . ., so that, given 
the origin of the File Block and the number of any File Control Block, the loca- 
tion of that File Control Block can be easily computed. If L is the File Block 
origin, the origin of File Control Block K is L+12(K— 1). 



The assignment of an input/output unit to a file is accomplished indirectly within 
a File Control Block by giving the location of a four-word Unit Control Block. 
It is in this Unit Control Block that the actual unit address is found. 

The Unit Control Blocks, one for each i/o unit attached to the computer, are 
located in the Basic Monitor. Within the table, the Unit Control Blocks are 
grouped in logical channels, where a logical channel consists of the blocks for 
all i/o units attached to one machine Data Channel. For convenience of refer- 
ence, the first logical channel is designated Channel A, the second is designated 
Channel B, and so forth. (Up to eight logical channels are permitted.) The 
Unit Control Blocks for all tape units of a logical channel occur together and 
are referred to, in order, by number (1, 2, . . .). Thus B3 refers to the third 
of the group of Unit Control Blocks of Logical Channel B which are assigned to 
tape units. 

If, in addition to tapes, a logical channel contains one or more units of card 
equipment, these units are designated as rdx, pbx, and pux for the reader, printer, 
and punch, respectively, on Channel x. 

A Unit Control Block contains, besides the corresponding i/o unit address, the 
location of the first of any waiting i/o requests made for that unit. If the Unit 
Control Block is for a tape unit, it also contains counts which specify the current 
position of the tape (file count, and record count within the file). 
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Configuration Options 



Control Cards 



JOB Caed 



FILE Card 



DATE Card 

LOAD Card 

RESTART Card 

IBSYS Card 
ID Card 

Control Card Formats 

JOB Card 



Any one of four distinct configurations of the iocs system may be used by a 
given program, depending on its requirements. These configurations are listed 
below (in order of decreasing generality and core storage requirements): 

1. Label iocs— This configuration comprises the complete iocs system. All of the 

described features are available; in particular, the labeling and label check- 
ing routines. 

2. Basic iocs— This configuration contains all of the iocs features except the 

labeling routines. 

3. Minimum iocs— This configuration deletes the following routines and features 

from the Basic iocs: 

JOIN STASH WEF BSF 

COPY HEW BSR CKPT 

4. Executor— This option consists of the trap supervisor and the iocs communi- 

cation cells. 

Seven kinds of control cards are recognized by the Preprocessor ( IOCS Monitor ) : 
job, file, date, load, restart, ibsys, and id. The load card is interpreted by the 
Preprocessor as the end of a control card set. 

The job card, besides supplying the job name, defines the length of the File Block 
and its origin in core storage, and the iocs configuration for the program. If no 
File Block origin is given, a "standard" assignment is made by the Preprocessor. 
This standard origin is the cell following the end of iocs, and depends on the 
system configuration specified. 

Each file to be processed is represented by a file control card. This card con- 
tains all of the information needed by the Preprocessor to generate a File Control 
Block. Space is provided on the card for a File Number which defines the relative 
location of the File Control Block within the File Block. The order of file cards 
in the control card set is immaterial. 

The date card provides iocs with a creation date for any labeled output files 
produced by the program. If this card is absent, the date is taken from the Basic 
Monitor. 

This card initiates loading of the main program. It must appear as the last control 
card and may contain a Basic Monitor System Unit in its variable field. 

This card initiates a restart from some previous checkpoint. It is equivalent to 
setting Sense Switch 2 down. 

The ibsys card transfers control to the Basic Monitor. 

The id card can contain installation accounting information. 
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Columns 



FILE Card 



Contents 



7-10 
13-30 

33-35 

44-48 
55-61 



*JOB 
Job name 

The number of File Control Blocks (N) in the File Block to 

be generated by the Preprocessor. 
File Block Origin (octal). If the standard origin is used, this 

field should be blank. 
Desired configuration for this job: 

MINIMUM— Minimum iocs 

BASIC— Basic iocs 

LABELS or blank-Label iocs 

EXECUTOR-Basic Monitor Executor only. 
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Columns 



Contents 



7-11 
13-15 



17 



18-21 



22-25 



NOTE: 



*FILE 

This number indicates the relative position of the File Control 
Block within the File Block. It must not be greater than 
the number punched in columns 33-35 of the JOB card. 

Tape mounting indicator: 

* — the file is to be mounted immediately, i.e., when starting 

processing, 
blank— this file is not required when processing is begun. 

UNIT1. This is the symbolic designation within the table 
of Unit Control Blocks, of the primary input/output unit for 
the file. If the primary unit is a tape, this field is in the 
form xn, where x is the logical channel (a through h) and 
n a relative tape number. If the primary unit is a card 
reader, card punch, or printer, this field is in one of the 
following forms: 

rdx— card reader 

pux— card punch 

phx— printer 
where x is the logical channel. If the file is an Internal file, 

this field should contain the designation "INT." 
UNIT2. This is the symbolic designation within the table of 
Unit Control Blocks, of the secondary unit for the file. The 
format of this field is the same as for columns 18-21. 



UNIT1 and UNIT2 fields have special tape assignment procedures to facilitate 
inter-system communication. For complete information about these procedures, 
refer to the bulletin entitled IBM 7090 Operating Systems: Basic Monitor (IBSYS). 
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Columns Contents 



27 List control 

N— Do not include this file in the Preprocessor File List 
blank— Include this file in the File List 

28 File type: 

C— Checkpoint 

I— Input 

T-Total Block Output 

P-Partial Block Output 

29 Reel control flag: 

M— Multi-reel file, unlabeled file only 
L— Search for label on open, labeled file only 
blank— Single reel file, if unlabeled; no label search, if 
labeled 

30 File density 

H— High density 
L— Low density 

31 File mode: 

D-BCD 
B— Binary 

M— Mixed mode, first record bcd 
N— Mixed mode, first record binary 

32 Labeling conventions: 

H— High density label 

L— Low density label 

S— Standard density convention 

blank— No label 

33 Block sequence numbering flag (significant for binary files 

only): 

S— Sequencing words provided 
blank— No sequencing words provided 

34 Check sum flag ( available for binary sequence numbered files 

only): 

C— Check sums included 
blank— No check sums included 

35 Checkpoint conventions: 

F— Write checkpoints on this file at each reel switch 

(labeled file only) 
C— Write checkpoints on the checkpoint file at each reel 

switch 
blank— No checkpoints initiated by this file 

36 Restart repositioning flag: 

N— No repositioning on restart 
blank— Repositioning on restart 

38-41 Reel sequence number of first reel to be processed in this file 
(significant for labeled files only) 

44-48 File serial number (meaningful for labeled input files only) 

51-53 Number of days file is to be retained 

55-72 File name 
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DATE Card 
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11 1 I 1 1,1 1 |l 1,1,1 1[1 1|1 l|l I 1 1 I 1 I 1 1 1 1 I I I 1 1 1 1 1 I I I 1 1 1 1 I 1 11 I I I 1 1 1 I 1 I I 1 1 I I 1 1 1 I 1 I I t 



000 00 0000 

II 11 II 14 11 79 17 11 19 19 

1 1 1 1 1 1 1 1 1 1 



Columns 



Contents 



7-11 *DATE 

13-14 Month (e.g., 06, 11) 

15-16 Day (e.g., 03, 21) 

17-18 Year 



LOAD Card 




l*LOADI 

! "I 
mi i 



i 



o o o o rfo o o o ojo o o o'o o o o o alo D C o o e 

1 2 3 4 S l| 1 1 9 10 11(11 I114isjl9 II 11 11 29 ll|ll 21 14 19 29 11 19 28 90 91 32 ii 34 35 J9 37 91 11 40 41 41 43 44 45 46 41 41 49 60 51 51 51 54 11 19 51 11 59 » 91 11 (1 14 IS 15 61 U » 19 II 71 71 14 15 11 H II 71 It 
1 1 1 1 I t|1 1 1| 1|1 II l|11 1 1 1I|1 I 1 1 1 1 1 I I 1 I I 1 1 1 1 1 1 1 I I 1 1 11 t 1 1 11 1 I 1 1 II 1 1 1 I 1 1 I 1 II 1 1 I 1 1 1 11 I I 1 1 I 



Columns 



Contents 



7-11 "LOAD 

16-21 System Unit (e.g., SYSIN2) If this field is blank, SYSIN1 is 
assumed. 



RESTART Card 



i- a tu 
z tr a. 

o < > 



/ i*RESTARTl 

! ■ ■ ! 
hi 1 1 

ooooouoooh a o|lo c o o c 0000000000000000000000000000000000000000000000000100000000000 

I 1 3 1 S t| 1 I > 10 11 11 13 tllll II II II 11 10 21 111] II 15 29 17 H 19 30 31 31 33 31 35 39 37 39 39 40 41 47 43 44 45 49 47 41 41 59 51 51 53 14 55 Mil II 51 10 91 11 II 14(519 17 (119 70 71 11 11 14 71 11 77 71 19 10 
I I 1 1 I 1|1 1 I 1 1|1 l|l 1 1 1 I 1 I I 1 I 1 1 I 1 1 I 1 1 1 1 1 I 1 1 I 1 I I 1 I I 1 I 1 1 1 1 1 11 1 I 1 11 1 I 1 I I 1 I 1 1 I 1 1 I I I I 1 1 I I 1 



Columns 



Contents 



7-14 



"RESTART 



IBSYS Card 



l-QLU 

o< >- 
UUI- 



^ l* 1BSYS l 
i II I 

!- : 

oooooolooo|||loooooooooooooooooooooooooooooooooooooaoooooooDoooooooooooooooooooooo 

1 2 3 4 3 l| 1 1 I 1111 11)1114 15 14 11 19 11 10 11 21 13 II 15 19 21 19 29 30 II 12 33 34 15 31 31 H 39 40 41 42 43 44 45 41 41 41 49 59 51 51 53 51 55 51 51 51 59 to II II 99 (4 (9 (9 91 M 19 70 11 12 71 11 73 K nil 79 H 
I 1 I I I 1|1 I 1 I 1 l|l I I 1 1 I 1 I I 1 1 I I I I 1 I I I I I 1 I 1 I I I 1 1 1 I I I 1 I 1 I I 1 1 I 1 I I 1 1 I 1 I I I I I I 1 I I I 1 I 1 1 I 1 I 1 I I 



Columns 

7-12 



Contents 



*IBSYS 
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Program Input 



Program Loading 



The Preprocessor will, in addition, recognize the following Basic Monitor control 
cards i 



SIB 
II 



g B t D e t D (I D D o e 

1 I ] 4 I I 7 I I Wlt1IllT«1SHITIIHIIiiaaHIIKIT7l!t)lllSI3M»3il1N7l«IIU4]UU4l4TU«lH51SlSlHHS<S7UMUeiUE]ein«BTi*nigTITIT3MnilTTn/IN 

1 1 1 1 ii 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 m 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 u 1 1 1 1 1 it 1 1 1 1 1 n 1 1 



This card can be used for installation accounting. 



/?IESYS 
II 



a 0||| D C D II Q 1 D D D II 

1 I 1 4 1 • 7 I lltllll»|4HUHIItl79 2tBnH»»777lnn3IS»H»3t37»a4I(l4!^UiS44 47 4(*tHSIUU94»»97!494nilUU44l!l«tieiH7»7177r7 7(75n777ll)lf 

1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 11 1 1I 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 



This card transfers control to the Basic Monitor. 

Note: 

$ IBSYS and ° IBSYS perform the same function. * IBSYS is a Preprocessor 

control card; $ IBSYS is a Basic Monitor control card. 



The program input for iocs consists of the following parts arranged in the order 
shown: 




In order that the iocs system will be as independent as possible of the assembly 
and program loading techniques used by an installation, the Preprocessor con- 
tains no specific program loading facilities. Instead, after the control card set 
has been read and processed, the Preprocessor merely executes a standard load- 
ing sequence for the Program Input Unit (all Data Channel Traps are disabled at 
this time) designated by the *LOAD card. 

1. The loader must not destroy the contents of that portion of lower storage 

occupied by the Basic Monitor or by iocs itself. 

2. No portion of the File Block should be destroyed during loading. 
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Part II: Example of the Use of IOCS 



Input 



Following is a sample data processing problem: preparing an updated master 
file incorporating all changes (including additions to, and deletions from the 
file). This section will show some of the ways iocs can be used to handle the 
input/output programming for the problem. 



Assume that one input file is the master file. This file is on tape in the binary 
mode and consists of 5-word records for various accounts; there are 100 records 
per block. An additional word is carried in each block; this word contains a 
block check sum and a sequence number. Each account on the file consists of 
a master record in the format: 



Word 


Contents 


Internal mode 


1 

2 
3 


Account Number 
Account balance 
Year-to-date dividend 


Binary 
Binary 
Binary 


4 
5 


Year-to-date tax 
Code (0) 


Binary 
Binary 



Each master record is followed by five detail records, with code numbers 1-5. 
These records have the format: 

Word Contents Internal mode 



1 Account number Binary 

2-4 Description BCD 

5 First six bits: Code Binary 

5 Last 30 bits: Detail balance Binary 

The other input is the transaction tape, which is written in the bcd mode. There 
are 14 words per record, one record per block. Transaction records have codes 
and 1-5 corresponding to the master and detail records. In addition, there is a 
code (7) for a deletion record. Type transactions have the format: 



Word 


Contents 


Internal mode 


1 


Account number 


BCD 


2 


First 12 bits: Account number (con 


't) BCD 


2 


Last 24 bits: Code (0) 


BCD 


3 


12 bits each: Month-day-year 


BCD 


4 


Old balance 


BCD 


5 


First 12 bits: Old balance (con't) 


BCD 


5 


Last 24 bits: Blank 


BCD 


6 


Balance change 


BCD 


7 


Dividend change 


BCD 


8 
9-14 


Tax change 
Not used 


BCD 



The other transaction types have similar format. 
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Output 



Output will consist of an updated master file; an error file, consisting of master 
records after conversion and transaction records in error; and a history file of all 
deletions and all type transactions processed. The last two files are in the format 
of the transaction tape. 



Processing 



The processing steps are: 

1. Compare transaction and old master file by account number. 

2. Write unmatched masters without change. 

3. Create a new master for unmatched transactions. 

4. Process matched conditions by type, as follows: 

a. For type 0, the old balance of the transaction is compared with the 
account balance of the master. If the balances are different, the master 
is converted to bcd and written on the error file, followed by all trans- 
actions. If the balances are the same, the new balance is posted. 

b. Types 1-5 follow in order. There may be multiple transactions of each 
type; if so, the date should increase. Update each detail type. 

c. On a type 7, the old balance must again match the account balance in 
the master. If it does not match, the account is written on the error tape 
along with the transaction. If it does, it is deleted from the master file 
and written on the history file. 



Programming the Input/Output 



Considerations which arise in using iocs for the input/output of the sample prob- 
lem are discussed below. 



File Specifications 



As the file specifications involved in the problem have no effect on the program- 
ming, it will simply be assumed, for purposes of discussion, that the File Control 
Blocks are defined as follows: 



MAITRE 


BSS 


12 


Old master file 


NEWMR 


BSS 


12 


New master file 


ERF 


BSS 


12 


Error file 


HIST 


BSS 


12 


History file 


TRANS 


BSS 


12 


Transaction file 



The following control cards might be used: 
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*D5HS ~ 1 

" \ 

III 

tltSIBMgil(0llll(lllCigi0lllll«tlia«ll0<lDB9»SttigiBI||||O0uD09BDnDI>l0QBtieD0 

im ii iiIiiii it 1 1 1 1 1 1 1 1 1 1 1 ii m it ii ii ii ii i "mi ii 1 1 n iiiiniiiriiii'ni'i'iiiniiii 

*B*YE 145S66 ' — \ 

III 

iiealiiKagiliiiteooogaoigooooioacaoaogioooDDtcsooioieDeBiiDiigooooQoaoaDQso 

I I III i l|i 1 1 1 1 n 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 ni'i'i 1 mm i 

III 1 1 111 ||i 1 1 1 1 1 1 1 J 1 7 1 7 7 7 7 7 7 1 7 7 1 7 7 7 7 1 7 7 7 12 1 7 I 7 1 7 7 1 ) ? 7 1 1 I ; ; J 1 1 1 ] ; ; , , ; ; ; ; ; j 7 j 



*tlLt S ■ t4 
II I I 



TT5 - 



1 



ERROR TILE 
I II I 
■ ■ ■ ■ 

itooADiDO>lllittatootiot|ieoDtotooi)oieagaoiigioasaiio(ii>)oiago«o<iaio(ooiincioai)oo() 

II 1 I I I II 1 1 1 It II 1 I I II I 1 I I I M 1 I I I M 1 I I I |l I I I 1 I II 1 11 1 I I I 11 I Ml II 111 I 1 I l | | I'll | )' !'" 

Il2li22i222iiii%i2 a 2121111111111 22 211112 l uimii 2121 1111112211 3m a tunp 



HISTORY FILE 
II II I 



■FILE 4 ■ B3 T LD 

II I I I 

III I II I 

laiOMtMtttotoiottDetngioliaoiotttioiiioooDDiDcotDOtotiiooiiigtioDDODosoMiiODoc 
i ii in miimi in M11M1I ti n ii 1 1 tmii i i|ii 1 1 1 1 itmii ii i u'i'i'i'iTi'i mm i'iiiii'i 

3 i 1 1 : 1 1 i 1 1 2 1 2 1 1 j : i V i i * J i J 1 1 1 * i * * i ) ! i J J 1 1 2 1 1 1 J 1 ! 1 1 1 1 1 1 11 ti : 1 1 1 ttt i 

i" ■ ■— '■'■ Jim ■»" ■■ ■' v m j.j i m — 

JJ3 



-irrre — s*m 
ii i 



i i 



i 



TRANSACT I OH TIlC 
II I II I 



III I I I II I 

{giiiiictsoiiiBttoftiitieeoDioititiia«ci)»io>]Digioti<|gio|ii|igii«iiDiDiecDiigto 

I I 1 I 1 1 1 1 I 1 I I It I 1 |1 1 I I M I 1 I I I I I 1 I I I I 1 I 1 |l I I I I I I 1 1 t I I I I I 1 1 l|l I I M I 1 I I I I II I 1 I I I I 1 
1 11212 J 2 1 2 1 1 1211111111711 1 1 1 1 1 1 1 2 1 1 2 1 J 1 1 ! 1 ! 1 1 1 1 1 1 1 1 2 1 1 1 1 1 J J 1 It 1 1 2 1 1 i t J 1 1 1 1 2 1 1 1 



*F7lC £ * t5I E2 PHHBLSC I 10 NEH MASTER FtLE 

II I I I II I I I I II I 

III II I I I I I 

imggioQogggggg0a*ggiifltG00i|igtoaMmD9ogigigg|B«g|gig||iaDmio<gHi>gigig 

I I 1 I I I 1 I 1 1 1 1 1 1 I 1 |1 I I I I I II 1 I 1 I I I M I 1 I 1 |1 I 1 I 1 I I I U |l I I 1 1 1 1 |l I I I 1 I 1 1 I I 1 I 1 | 1 I 1 I | | 
21 11112121 2 tit lit 1 11 til 2 121 jl tl 1 J 11 11 11 11111212121 21 11 11 ltUll 11 12 12 2212} 2 121 



TILE 
II 



1 * US S5 IMHBLSC [ 55T" 

II I 
III II 

tggggitiigigioiitiiioiot(i<igi|it*D«giiiiigigitgi 

ii it mini i |n i |ii i i|iiiiiii i ii ii ii i i|t i inn ii i 

I t221172112121111il21111111jl2tlllllllll221tlllll 



-I3ST 

III 

• tagimti 

1 1 1 1 i 1 1 1 1 

llZlZIIIll: 
3311111133 

4(4t<4|4<4 

S5i iiS!5ib 

igiggggi|t 

71 1 JTITJTJ 

mining 

■9199)9913 



SAMPLE PROBLEH 
II II 

III III I I 
llllllOMHMIiaillll 

1 1 1 1 1 1 1 1 1 1 1 1 1 1 11 
iiliiijitmliiii.iaii 

91])]l|113313|mi]13 
4414|4(444t4444|44444 
liSS919|SSSSS9|SSlllS 
llll[lllltl|(ettf(ici 

niTilinliniinnr 

IIIIIIIIMMMIIIIIM 

1 9 1 s a * ,• * , 9 , 2 PS S ' S S * 5 * * ' 



OLB HASTEfr FILE 
I I I II I 
II I II 

i • o* a *s « tj||ito ■• • la 

1 1 1 1 1 1 1 |i 1 1 1 1 1 ii 1 1 

Illl2l21t2121lll21 



1III0M1 
1 I I I I I I 1 
21212112 



lllllllllllllll 

I I 1 I 1 I I II I I I I I 



itiii: 

13331: 
44444< 
iiiii 
(till 

mil 

111(8 
9)939! 



i g i g d b o i o g i o o o * g a i 

1 1 1 1 1 1 1 m 1 1 1 1 1 1 1 

112111121111222111 
333331111313131333 
44444444444444 4 444 
S SS 5 5 5S5S55 Si SSSS S 
i 6 I 1 1 t ( 5 S C t E E 6 I 6 t 1 1 

jmmimiinm 

III tl HUB 19191)19! 
919)199 99 999999999 



ggggatga 

1 1 1 1 1 1 1 1 


11111 


21211111 


12171 


33113331 


J33S3 


S5S SS SS 5 


5 5S5S 


IEtlC)19 


S 65 66 


71717)11 


7 1)11 


1)1)1)39 


1 II It 


19)13919 


9999) 



Buffer Pools 



Note: 

References to actual units are interpreted as relative references by the Basic 
Monitor. The "LOAD card may have a particular unit designated in columns 
16-21. If no unit is specified, the Preprocessor will initiate loading from SYSIN1. 

The five files fall naturally into two groups: the two master files, which have 
large block size, and the other three files with small block size. Because of the 
disparity in block size of the two groups, it is desirable to use two buffer pools. 
Suppose these to be located at bigbuf and lilbuf, and that sufficient core storage 
space is available. The first instruction sequence is : 

f FOR REMARKS 



n 



LOCATION 
I la t 



,T,S,X. , , , I ID.E.F.T.N.F. ,,4. 



OPERATION | j ADDRESS, TAG, DECREMENT/COUNT 



DEFINE BIGBUF POOL AS TEN 

' ' ' ' ' ' ■ ' ' ■ ' ■ -J I 1 I L 



P.Z.E, , , , I lB,T,n.RTIF. 



501-WORD BUFFERS 

-J 1 1 1 I I I 1 I I I L 



P,Z,Ei 



. I iliO 5,0,1, 



nSiXl 



IDE FINE,, ,4, 



DEFINE LILBUF POOL AS TEN 



_i i i i_ 



P.Z.E. 



iL,I,L,B,U,F, 



12-WORD BUFFERS 



Pi Z i E , 



'1.0 ia. 



-J .1 \ I ' I I 



_J I \ \ \ L_ 



-1....L ..J 1 -I __ I 



501 words are needed for each buffer in the bigbuf pool because the master files 
have block check sums and sequence numbers. (This extra word will be auto- 
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Initialization 



matically bypassed by the system routines, and the programmer will never be 
aware of it again unless an error occurs. ) Specifying ten buffers for each pool 
is, of course, arbitrary and subject to space limitation. There are 5032 cells in 
the bigbuf pool, and 142 cells in the lilbuf pool. 



The following list (actually two separate lists) is placed in storage: 

i — * FOR REMA RKS 
I LOCATION 

lit 
JLiIiSiTjlI 



JiZiE.1 



OPERATION 



.SiYNi 



EZJEu. 



EiZjKl. 



EXEj. 



<,7.,V.. 



| ADDRESS, TAG, DECREMENT/COUNT 
i 
islie 



H1E1WMR 



o2^L 



M,A,I,T,R,F, 



lr.R,A,N,s. 



HI.S.T, 



1K1R1F1 



NEW MASTER FILE IS IMMEDIATE 

■ -i — i — i — i — i — i u_j i_ 



OLD MASTER FILE IS A RES.ERyE , 



FILE HAVING TWO BUFFERS. 

■ ■ ■ J — i — i — i — i — i_i i i i i ' ■ ■ i 



_j — i — i i i_ 



TRANSACTION, HISTORY, AND 

■ '-i — i — ( — i — l_ 



_L_J I I L- 



ERROR FILES ARE ALL IMMEDIATE 

' ■_] — i — i — i — i — i — i — i — i — i — i — i — i — i — i — i — i i 



The following initialization sequence is then used 



r 


-* FOR 


REMARKS 




















f 


LOCATION 
2 t 


7 


OPERATION 

8 14 


i ADDRESS, TAG, DECREMENT/COUNT COMMENTS ] 
i f 
IS| 16 








T,S,X, , . , 


IATTAC.H 4 ATTACH MASTER FILES, AND , 














IB.IG.B.U.E 
















OPEN NEW MASTER, 












P,7,F„ , , , 


!l,i,s,t,i,.,. 


?, 


























T.S.X, , , , 


iA,T,TA,C,H,, 


4 














ATTACH AND OPEN TRANS- 












P.7.E. , , , 


lL,I .L.BrU.F, 
















ACTION, HISTORY, AND ,,,,,( 














i 


3 














ERROR FILES. 1 














i 

lo.P.EiNi ,i4i 
















OPEN OLD MASTER FILE. 1 














lM,A,T,T,R.E 















































' ' 1 » ' ' ' ' • ' 1 



The old master is treated as a reserve file in order to assure that two buffers are 
always available for it. Two buffers are necessary, since each block has 100 rec- 
ords, which is not a multiple of the number of records (6) per account, so that 
during the reading process ( see below ) the records may be in different buffers. 



Processing Master Files 



The old master file is read by the sequence: 

-* FOR REMARKS 



1 LOCATION 
i is e 


7 


OPERATION 

S 14 


19 


ADDRESS, TAG, DECREMENT/COUNT COMMENTS 

16 






T.S.X, , , 




t, w » r. ji READ OLD MASTER FILE 




P,K,F, , , 






M,A, T.T.R.F, , 


.iPROSS 








LOCATINp:, 








P,7.,Ei , , 






NiOiNiE, ,i, T 


JaLuTi i i 














lio.x, , 


i.ocp.n, 






*,*,., .-,5. 




















MASTER ACCOUNT RECORE 






ilO.2, i 

lin.a, , 


IO.CP.N, 






*,* 5, 




















ACCOUNT DETAIL, CODE 1 






TO.CP.N, 






*,*,,,, ,5, 




















ACCOUNT, DETAIL, CODE 2 




. .J_L 


llQ.4, i 

It fiiR , , 


IO.CP.N. 






*,* 5, 




















ACCOUNT DETAIL, CODE 3 




TO.CP.N, 






*,*,,,, ,5. 




















ACCOUNT DETAIL, CODE 4 






lO.C.T.N, 






*r*, 1 .5 i 




















ACCOUNT DETAIL, CODE f 5 






LAC, , , 


- 




IO,l,. ,1, 




















BEGIN PROCESSING WITH, 




- 


























MASTER ACCOUNT RECORE 


. 




































::/ 



When pross is reached, each of the commands 10I-106 will have the address of 
the first word of the corresponding record type for the current account. 
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When the account group is to be written on the new master file, all that is 
needed is: 



i— * FOP 


REMARKS 








































1 LOCATION 
1 12 • 


7 


OPERATION 
a 14 


19 


ADORESS, TAG, DECREMENT/COUNT COMMENTS 
16 


i . , 


i — 1_ 




T.SX. . 








W,R,I,T,E..,4, . , 


WHITE ON NEW MASTER, TRANS 7 J 








P.7.F. , 








ta.F.WMH i 


















MITTJNp EACH RECORD, FROM rr,S 


!oU,T 


1 




IO.CP,* 








IO,l,. .5, 


















LOCATION IN THE INPUT BUFFERS. 


— ! — 1 1 






I.QCP* 








IO,2,. 


, |5, 






























1 1 1 






I.O.C.P,* 








IO,3,. 


. a, 






























1 i i 






I .OCR* 








m,4,, 


, *■ 




























_^ 


1 i i 






i,o,c.p.* 








IO,5,. 


. n, 




























1 i i 






I,0,C,T,* 








10,?,, 


, a, 






























I 1 1 






■ i i i 








— I — i — l — i 


• ■ 


i i i l 
















III! L.-J 




1 1 






1 , ,| 
1 II, 



Since the indirect effective address is computed without index registers, the non- 
transmitting bits in the tags of the commands 10I-106 have no effect. 



Processing Transaction Files 



The transaction file is read by the sequence: 



1 


-* FOR REMARKS 




LOCATION 

2 6 


7 


OPERATION 
9 14 


| ADDRESS, TAG, DECREMENT/COUNT COMMENTS ) 
IS* 16 \ 




iiit 




T.S.X. , . , 


!RE,A,D,..4 , READ, TRANSACTION, FILE. TRAN5-. 




— 1 — j 1 t 


P,Z,E. . , , 


*\R.A,N.S....W.3,-K1 MITTING ACCOUNT NUMBER _ , , 




1 1 1 1 


P.Z.K, , . , 


INOM.O.R.E R,K.n,TT,N, , . , AND CODE TO WORKING 




1 1 1 I 


i,o,c,p, , , 


IW.O,R,D,l 2 STORAGE, AND LOCATING . 




W,3, , , 


I,0,R,T,N. , 


* * * * THE REMAINDER OF THE RECORD. 




— 1 — 1 — i i__ 





' 1 1 , 1 1 1 1 1 , 1 1 1 1 1 _.i , , , , 1 , , , , 1 , . 1 , 1 1 , 



Since the sequence ends with a non-transmitting buffer control command, the 
entire transaction record is available in the buffer. In addition, the account 
number and type code are in cells wordI and wordI + 1, ready for some con- 
version routine. The address of the command in location w3 has the buffer 
location of the data fields for this transaction. 

Since the transaction, error, and history files are attached to the same pool, any 
transaction which has been read by the sequence above can be written by: 

'* FOR REMARKS 



t 



LOCATION 
lit 6 



-1 — I 1 i_ 



I, 1 1 ■ 



OPERATION 



'SiX. 1 , , 



PiZiK. 



( l ADDRESS, TAG, OECREMENT/COUNT 
1 

is lie 



cc 



! C '°'P'Y'--4 



JTiRiAiNiK.,1, iH,TiS.Ti(m,r. J i; ,R, PI ), 



I I 1 1 



I I I ' 1 1 



— 1 — 1 — 1 1 ' 



End of File: Transaction File 



When the transaction tape is depleted of records, the read sequence will exit to 
the routine at location nomore. That routine will handle the case of an end of 
file on the transaction file before the old master has reached end of file; the rou- 
tine at none will handle the case where end of file occurs first on the old master 
file. In the first situation, processing is finished on the files trans, erf, and hist, 
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and the problem is completed by copying the rest of the old master onto the new. 
The completion is carried out by: 



\ft 



* FOR REMARKS 



NlQMQRE 



FIIN.D . 



TS,X, 



P, Z,E, 



PUiPiE. ■ 



Lhl*. 



EiNiD, 



T,S,Xi 



P.Z.E, 



T.C.H, 



IiSjXl 



Pt ZiEi i i l 

P1Z1E1 — i — i— l 



I.O.RiTN, 



Ci LiA t i i j. 



S.TjDl 



ISjXl 



xaAi. 



T,S,X. 



P. Z , E , , L _ y . 



(L L . O . SE,, , 4 , 



iW i R i I i T i E i .,4 , 



fcLEJSIMfl- 



OJLlTiIi 



JRiE .AD,. i4. 



ADDRESS, TAG, DECREMENT/COUNT 



_j i i — I — i — i — u 



I IM,A,I,T,R,E,.,.,D,U i; 

JEjCLDl^lIJiLi-Tl 



ill 



F,I,L,L, 



WlBlIi T i E ,^. 



NE ,WMR 



;dup,e,. i. ,*,*, 



EJlNjD_L 



C,LiO,Si E,,|4| 



XaJjSiTiI i,i, i2x__i 



CLOSE TRANSACTION .ERRqR, 



AND HISTORY FILES, WITH , 



R EjWJfND.-IjN^pA D, 



PUT OUT THE CURRENT 



ACCOUNT RECO RD 



LOCATE WORDS 



REMAINING IN READ 



BUFFER 

J I I I I I l 1 L_ 



SET UP WRITE SEQUENCE 

i i i i i i l-i i_L_r i i — l_ i_ 



TRANSMIT INFORMATION FROM 

_i i i i i j — i - j — i - j — i ' ' 

INPUT TO OUTPUT BUFFERS 

' i ' i i i I I — l._LI_l_l_Ll. _1__ 



CLOSE MASTER FILES WITH 

_j_ ]_J_J_I_1— I- I I I I I— L-L-J— L 



REWIND-UNLOAD 

_l I I L._l I I - 1 I — 1 — 



The first write, at nomore +2, writes the account records which had previously 
been located. The loop from find to fill+1 copies the remainder of the old 
master file onto the new master file. When an end of file is reached on the old 
master file, the close at end writes the trailer label and rewinds and unloads the 
files. This use of record control for the read location and count control for the 
write transmission completely eliminates the problem of adjusting for the fact 
that the old and new master file records may be in different positions within the 
block. 



End of File: Old Master File 



The routine at none handles the case which arises when an end of file occurs on 
the old master before it does on the transaction tape. In this situation, new 
masters are to be created from the transaction tape until it is exhausted. Instruc- 
tions to do this are: 




and (when the account group is complete) : 



52 



r r 


-* FOR REMARKS 




























1 LOCATION 
l It 6 


T 


OPERATION J 

• ulis 


ADDRESS, TAG, DECREMENT/COUNT COMMENTS 
Ifi 






— i — i — l_j 




!LaJL_i_ 


, ! 


WRITE... 4 WRITE OUT NEWLY CREATED 




— i — i — i l 


PZE, 


i 


NE.WMR. , . 




















MASTER FILE RECORDS. 




— I — I l l 


I.OCT, 
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WSAG, ....3.0 
























— i—i — 1 1 


TRA, 


, ! 


N.ONE-1,2, , 
























FINAL 


xax, . 


' ' 


CL0.8.E...4, 




















CLOSE NEW MASTER FILE \ 




— i — i — i — i— 


PZ,E. , 


, i 


N.E.WMR , . 


























1 * ' i 


T&X, 


— 1_.' 


CLOS.E.,4 




















CLOSE TRANSACTION, ERROR 






! L_l 1 


PZE 


; 


L,IS.T,2....,3 
















- 1 ■ -*--' L — ' ' ' ' A 

AND HISTORY .FILES \ 




1 1 1 1 


. , . , 


, ' 


_ — , — i — . i , . , 








-i .. 


■ ' 


_J — l_l._L.i i I . 1 i . , . , \ 



Variable Length Records 



To demonstrate the flexibility of the system, suppose that the master file records 
are of variable length. Assuming the convention that the first word of a variable 
length record is a flag word of the form: 



t 



* FOR REMARKS 



LOCATION 



OPERATION J I ADDRESS, TAG, OECREMENT/COUNT 



i i 
i 

itlnin 



LQCJ PiN i 



1 1».«„ 



i i 
i i 



iAi 



-i—i i_ 



_i — i — i i ■ > i 



-J — i — i — i — i — i i i i i i i ■ i ■ ■ 




where n is the number of words in the remainder of the record, and assuming 
also that a record will not span a block, the master file is now read by: 



p* FOR REMARKS 












1 LOCATION 

lit e 


OPERATION 
7 s 


j j ADDRESS, TAG, DECREMENT/COUNT COMMl\ 
« 'is! ie 


1 i i ' ■ 


T.8.X. . . . 


1 1 






— 1 — I i i i 


PI 7. TO, . . . 


1 IM.A.T.T.B.TS t . 


,P,R.os.a, , 






— 1— 1 i i i 


PIZE, , , . 


! In,on.r 1 .,.t.t 


.T„T1 , , , , 




• . 


ii.ii 


i,ac.n , , 


1 i*i+i1i, ,, il 1 1 






READ IN FLAG V 


/ORD AND 1 


It ,0.1. . 


9.7.F., . . . 


1 1*1*1 , 1 ■ • , 






EXECUTE IT. 


( 


_j— j — i i i 


IiQCP, . . 


1 1 

' i*i+il,. 1. il, . 










It ,0,2, , 


P.Z.K, , , . 


! !*■* 










I,.,, 


i.rtr-.n , , 


1 1 

_!_ !*l + ll ., ,, (1 , 1 










il/l.S. . 


P.Z.F.. , . . 








. 




1 1 > 1 1 


IiOC.P. . , 


j 1 

1 i*i+,1i,. ,, ii , , 










!lO,4. , 


nztEi 1 1 1 


1 , 

! ! * * 

1 l*.*l 1 , 1 1 1 






. 




1 1 1 1 1 
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II 
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liniB. . 
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' 1*'* 






• 




— 1 — 1 — 1 1 1 
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_i__.i*i+.l 1. 1. il 1 1 
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! !*.* 










— ! — 1 — 1 — I 1 


T.an.T.M, . 
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TERMINATE I/O 
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tPR.O.SS 
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1 lio.i,. ,1. , . j 










i,,,,l 


_.! 1 1 1 I 1 


1 1 

J — 1_. 1 1 1 1 I , , , 
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at iol, io2 
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ecrements. Hence, 


as for the 
processing 
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can be basically the same. Writing is accomplished with special count control 
to insure that records do not cross a block gap. 

Inasmuch as the program will terminate either by an end of file on the old mas- 
ter or on the transaction tape, the programming above is all that is needed to 
meet the input/output requirements of the problem, except for routines at tilt 
and hedun to take action on error conditions. Such routines are subject to varia- 
tion according to installation practices. Discussion is, therefore, omitted. 
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Part III: 



IOCS Operation 



Section 1 — Control Sense Switches 



Four control sense switches are used by iocs, the actual assignment of which is an 
installation choice. In this manual, the switches are referred to by their functional 



names. 



Input Control 



Restart Control 



Checkpoint Control 



Label Control 



Error History Control 



Input control ( Sense Switch 1 ) is a function of the Basic Monitor. See the bulletin 
entitled 7090 Operating System: Basic Monitor (IBSYS). 



Up The Preprocessor assumes that a new job is being started. 
Down The Preprocessor assumes that a job is to be restarted, using checkpoint 
information from tape. 



This switch is tested before every exit from an iocs subroutine. 

Up No action is taken. 

Down A checkpoint is written, provided that a checkpoint file has been opened. 

Once a checkpoint has been written, this switch must be returned to the Up 

position and sensed there by iocs before it can again be placed Down to cause 

writing of another checkpoint. 



This switch is used by the operator to indicate which of two possible actions 
should be taken when a label error is detected. 

Up When the Start key is depressed, the tape in error is rewound and un- 
loaded. When a new reel has been mounted, the label check is repeated. 
Down When the Start key is depressed, the tape is accepted despite the error. 



If one or more tape redundancy errors ( correctable or uncorrectable ) occur while 

processing a tape reel, a summary of this information is printed when the reel 

changing instructions are given to the operator. If no redundancy errors are 

detected, this summary is normally not printed. 

This sense switch makes it possible to print the redundancy error history of each 

tape reel processed, whether or not errors occurred. 

Up Print error history only if one or more errors occurred. 

Down Print error history for each reel. 



The standard sense switch assignments are as follows: 



Function 



Sense Switch 



Restart Conrtol 2 

Checkpoint Control 3 

Label Control 4 

Error History Control 5 

These assignments may be changed by re-assembly with appropriate changes in 
assembly parameters. 
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Section 2 — System Operating Notes 
Start Procedure 



Since iocs is a participating system under Basic Monitor control, the iocs jobs are 
stacked on the Basic Monitor Input Function SYSIN1. All iocs jobs which 
are arranged in this manner are usually separated by EOFs on SYSIN1. 

1. The first card of a stacked run is the IB SYS control card: 



SEXECUTE 
I II I 



1 ocs 
I i 



0| 1|| D a 0| M fl D U o a 9 I) 

1 I 3 4 B I 7 I I Mil 12 13 14 IS II 17 II II 31 21 2313 3I212I1I2I2I3I3I3133141S3I2I »»« 41 43 4344414141414111 SI S3I3S453SS SI SISIU II U13B1S5IIB7BBN7S 7173 73 74 75 7177 71 TBI! 

1 1 1 1 1 1 1 1 1 1 1 1 11 1 II 1 It 1 1 II 1 11 t 1 I 1 I 1 I 1 t 11 I 1 11 I 11 1 1 II 1 1 1 II 1 II I 1 1 I 1 11 I 1 1 1 I I 1 1 1 I 1 1 1 1 I t 



This card calls in the IOCS system monitor and transfers control to it. 

2. At the completion of each IOCS job, scanning for the next job is resumed. 
At the end of all jobs, control should be transferred back to the Basic 
Monitor with one of these cards: 



5 IESYS 
II 



ooollloooBoaoooooooaooooaoooaooooaaooooaooooooQaooaooaoooooooooaooooooooooooiiaoo 

I 1 3 4 I I T I I Nllt!t3l4|}ltlll|ll!s2lllfl2425»21iaaa3IS331M»3l373iail4l4!414l4l«47 4l4SHB1SIS3S4H^ 

II II II I 1111 I 1 11 I I 1111 1 II I 11 1 I 11 1 I I 11 1 II II I I 1 II I 11 I I 11 I 11 11 I HI 1 I 11 I I 111 I I 11 I I I 11 



System Operation 



*msvs 
11 
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The control cards are read. If any errors are detected by the Preprocessor, an 
error list is printed. 

2. The Preprocessor prints a file list. 

3. If one or more tapes are to be mounted immediately, or if an error list was 

printed, one or both of the following messages may be printed: 

MOUNT INDICATED TAPES 

CONTINUE IF CONTBOL CARD ERRORS CAN BE IGNORED 

If a halt occurs, the operator may depress the Start key, after any required 
tape mounting, to continue. 

4. The object program is loaded, and control is transferred to it. 

5. If the program takes the recommended action when the job is completed, the 

system informs the operator of this completion and calls the iocs monitor. 

6. If an end of file is encountered while reading control cards, the message 

CONTROL CARD EOF 

. . , PRESS START TO CONTINUE 

is printed. 

7. Any error halts or illegal loops should be dealt with as follows: 

First, execute a str. This will preserve the loop location and will enter the 
Basic Monitor dump routine, sysdmp. When the core dump is complete, 
control is transferred back to the Preprocessor ( iocs Monitor ) . 
If, for some reason, the str fails, enter sysdmp directly by a transfer to 
location 115 8 . This will give the same results as the str, except that the 
loop/halt location is not preserved. 
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Preprocessor Error List 

The Preprocessor prints an error list if one or more errors are detected while the 
control cards are being processed. Each error message in this list is of the general 

form: CARD XXX (Error Condition) 

For each error condition the Preprocessor takes some specific action to permit 
further card processing. A single halt occurs just prior to program loading if any 
errors have been found in the control cards. 

Preprocessor Error Messages 

ILLEGAL OPERATION -(XXXXXX) 

Columns 7-12 of a control card contain XXXXXX which is not *job, 

*FILE, *DATE, *LOAD, ^RESTART, Or *IBSYS. 

FILE BLOCK ORIGIN NOT OCTAL 

The origin specified in the job card is ignored, and the standard File 
Block origin is used. 

FILE CONTROL BLOCK COUNT ERROR 
The value 50 is used for the count. 

FILE CONTROL BLOCK NUMBER ERROR 

The field is either non-numeric or greater than the count given in the 
job card. No File Control Block is generated for this file. 

UNIT1 ILLEGAL 

The field does not contain a proper designation. No unit Control Block 
location is stored, and any reference to the file will cause an error halt. 

UNIT2 ILLEGAL 

If unitI was correct, that designation is used for unit2. 

DATE ERROR 

The date from Basic Monitor is used. 

JOB CARD OUT OF PLACE 
The card is ignored. 

CONTROL CARD REDUNDANCY 

A redundancy has been detected while reading control cards from 
tape. The card is processed as read. 

REEL SEQUENCE NUMBER NOT NUMERIC 

The sequence number is assumed to be 1. 



Preprocessor File List 



The Preprocessor prints a list of all files which the program is to use (see page 
58). The following information is given for each file: 

File number 

File name 

Physical i/o unit assigned to the file 

Starting reel sequence number 

If the file is an output file, what kind of tape to mount (labeled or unlabeled 
blank) 

Whether the file must be mounted initially. 
If two i/o units are assigned to a multi-reel file, the entry for that file consists 
of two lines, one for each unit. 
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For an output file, one of three mounting instructions may be given: 
BLANK - UNLABELED 
BLANK - LOW DENSITY LABEL 
BLANK -HIGH DENSITY LABEL 

A file which is to be mounted immediately is marked with an asterisk (*) to the 
left of the line. Instructions for the mounting of files not so marked is deferred 
until the file is brought into use. 

Sample File List 



JOB - TEST 6 DATE 6/30/60 

FILE DESCRIPTIONS (MOUNT FILES MARKED WITH *)- 



PAGE 1 



NO. 


FILE NAME 


1 


FILE A 


2 


FILE B 


3 


FILE C 


5 


FILE D 


7 


FILE E 


10 


FILE F 


11 


FILE G 


12 


FILE H 


21 


FILE K 


22 


FILE L 


25 


FILE M 


26 


FILE N 



UNIT MOUNT TAPES — 

Al REEL 0001 

A2 REEL 0002 

A3 REEL 0002 BLANK-UNLABELLED 

A5 REEL 0003 BLANK-LOW DENSITY LABEL 

A6 REEL 0004 BLANK-LOW DENSITY LABEL 

A4 REEL 0001 BLANK-HIGH DENSITY LABEL 

Bl REEL 0002 

B2 REEL 0003 BLANK-LOW DENSITY LABEL 

B3 REEL 0001 BLANK-HIGH DENSITY LABEL 

B4 REEL 0002 BLANK-HIGH DENSITY LABEL 

B5 REEL 0002 BLANK-LOW DENSITY LABEL 

Al REEL 0002 BLANK-LOW DENSITY LABEL 

A2 REEL 0003 BLANK-LOW DENSITY LABEL 

A3 REEL 0004 BLANK-LOW DENSITY LABEL 

A4 REEL 0001 

A5 REEL 0002 BLANK-LOW DENSITY LABEL 

A6 REEL 0003 BLANK-LOW DENSITY LABEL 



IOCS System Messages and Halts 



A number of messages are printed on the iocs system printer during the execution 
of a program. Some of these messages merely record the normal operation of the 
system. Others request some operator action, or describe an error condition 
which has been detected. 

Associated with operator action and error messages, there are two procedures in 
iocs: 

(1) A mnemonic core dump on sysouI and a return to the iocs monitor occur 
when some error condition is detected which makes it impossible to continue. 
The information printed at this time is of the form: 



(Specific error message) 
CANNOT PROCEED 



(2) 



HPH 



-1 
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(The Instruction Counter at this point is in the ioex communication area.; 
This stop occurs when some operator action must be taken (e.g., tape mounting), 
or when a condition is detected within iocs which may or may not be a significant 
error. 

The message at this time can take one of two forms: 

(a) If the operator is required to take some action, the following message is 

' (specific operator action request) 

OPERATOR ACTION PAUSE 

When the Start key is depressed following this stop, the following line is printed: 

ACTION COMPLETED 

(b) If the halt occurred because of an error condition, the following message is 

printed: 

(specific error message) 

PRESS START TO CONTINUE 
When the Start key is depressed following this stop, an additional line is printed: 

CONDITION IGNORED 



Tape Mounting and 
Removal Messages 



Normal Label Messages: 
Output files 



REDUNDANCY HISTORY XXXXX RECOVERED XXXXX 



iocs assumes that those files marked for immediate mounting by the Preprocessor 
File List have been mounted. Thereafter, all necessary instructions to the oper- 
ator to remove or mount tapes are printed by iocs. 

1. Mounting instructions are printed for any Immediate file when the file is at- 

tached, and for any reserve file when opened, except those indicated in the 
File List for immediate mounting: 

(REEL YYYY ] 
UNIT XXXXX (filename) MOUNT J BLANK L 

[LAB. BLANK] 
Density of label can be determined from file list. 

2. A history record and removal instructions are printed for each reel, of any file, 

which is rewound and unloaded: 

UNIT XXXXX (file name) REEL XXXX- XXXXX RECORDS 

{ERASE) 
[PERM. } 

This message shows the number of redundancies corrected, and the 
number of erased areas when writing (erase) or permanent redun- 
dancies when reading (perm.) The Error History Control Sense 
Switch can be used to force printing of this message when the error 
counts are zero. The message is always printed when the counts are 
non-zero. 

UNIT XXXXX (file name) REMOVE REEL YYYY 

3. When reel switching occurs for multiple reel files: 

a. If a single i/o unit is assigned for the file, iocs halts to permit the reels to 
be changed. 

b. If two units are assigned, iocs does not halt, but automatically begins 
processing the second unit. 

In both cases, the removal and mounting messages are printed. 

If a labeled output file is to be prepared, the blank tape on which the file is to be 
written must possess a label when mounted. 

The labeled tape can be obtained in two ways: 



59 



1. By using a tape on which some labeled file has already been written, if the 

tape need no longer be retained (this requires that the file Creation Date 
+ Retention Days be less than the current date). 

2. By creating a dummy label on the tape by an off-line card-to-tape operation. 

When a labeled output file is opened, the following message is printed to indicate 
the contents of the label: 

{HIGH) 



UNITXXXXX (file name) LABEL DENSITY, 
(label) 



LOW \ 



Input files When an input file is opened, a label is read and compared with the informa- 

tion given on the corresponding file card. If a disparity is detected and the 
file card does not specify searching, the input heel invalid error occurs (see 
label error messages). However, if searching occurs, each label encountered is 
printed on-line until the desired file is found. The complete message is: 

(file name) SEARCH SKIP LIST FOLLOWS IF SSWX DOWN REMOUNT 
(label of file skipped) 



(label of file skipped) 
(file name) FOUND 

Reel switching may occur automatically during the search. Also, if the specified 
sense switch is depressed during the search, a rewind and unload is issued and 
the search will continue on the next reel mounted on that tape drive. 

Label Error Messages UNIT XXXXX ( file name ) LABEL ERROR 

(label) 

(cause of error — see below) 
IF SSWX DOWN IGNORED 
OPERATOR ACTION PAUSE 

causes of error: 

a. INPUT REEL INVALID 

Either the file serial number, the reel sequence number, or the 
file name is incorrect. If the Label Control Sense Switch (see 
page 55) is Down when the Start key is depressed, the reel is 
accepted as correct. If the switch is Up, the tape is rewound and 
unloaded. When a new tape is readied, it will be checked. 

b. OUTPUT REEL INVALID 

Reel not labeled (i.e., the label does not begin with "Ihdr" or 
"Iblank." If the Label Control Sense Switch is Down when the 
Start key is depressed, the dummy file serial number ***** is 
used for the label. If the switch is Up, the reel is rewound and 
unloaded. Then when a new reel is loaded, the label will be 
checked. 

c. RETENTION NOT EXPIRED 

For tape xxxxx, (creation date + retention days) > (current 
date). If the Sense Switch is Down when the Start key is de- 
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pressed, the reel is used for output. If the switch is Up, the 
tape is rewound and unloaded. Then when a new reel is readied, 
it will be checked. 

d. NO LABEL, BLANK CREATED 

The record read from an output file as the label was not fourteen 
words in length. If the Label Control Sense Switch is Up, the 
tape is rewound when the Start key is depressed. When a new 
tape is readied, it will be checked. If the switch is Down, the 
system will proceed. (Note: Care should be used, since a 
lBLANK-type label is created, which may cause a subsequent 
error message.) 

Miscellaneous (file name) NO LABEL, BLANK CREATED 

Label Error Messages The record read as the label of an input file was not fourteen words 

in length. A Iblank image will be created in the label area; this 
will probably result in a subsequent error message. There is no stop 
associated with this error. 

(file name) NO TRAILER 

The record read as the trailer label of an input file was not fourteen 
words in length. The end of file condition is assumed. There is no 
stop associated with this error. 

File Processing Error POOL ERROR TSX AT XXXXX 

Messages CANNOT PROCEED 

An attempt has been made either: (1) to define a buffer pool using 
the storage area occupied by iocs; (2) to join a buffer pool to a non- 
existent pool; or (3) to join a pool to two different pools. 

ATTACH ERROR AT XXXXX 

CANNOT PROCEED 

There are not enough buffers in the required pool to attach the speci- 
fied files, xxxxx is the location of the tsx attach, 4 instruction which 
caused the error. 

(file name) NOT AVAILABLE FOR INITIALIZATION 

PRESS START TO CONTINUE 

An attempt has been made to attach a file which has already been at- 
tached to another pool or previously closed with a Rewind Unload. 
If the Start key is depressed, the program continues but the file is not 
opened. 

ILLEGAL FILE USE 
CANNOT PROCEED 

This message indicates that a file designated as Total Block Output 
type is used for Partial Block Output. 

(file name) OPEN COUNT EXCEEDED-OPEN NOT POSSIBLE 

PRESS START TO CONTINUE 

An attempt has been made to open too many files in a Reserve or 
Internal Group. If the Start key is depressed, the program continues 
without opening the file. 
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ILLEGAL TRANSMIT |*j^?JxXXXX 

CANNOT PROCEED 

This error is caused by an attempt to read a word from or write a 
word into the area occupied by iocs, xxxxx is the location of the 
iocs command which caused the error. 

ILLEGAL UNIT REQUEST/TRAP AT YYYYY 

CANNOT PROCEED 

yyyyy is either (1) the address of a select instruction which refers 
to an illegal or unavailable unit or (2) the location where the 
machine trapped for a non-existent channel. 

Tape Error Messages UNIT XXXXX FILE XXXX REC. XXXX PERMANENT READ REDUN. 

A specified number of consecutive redundancies have occurred while 
attempting to read an input record. The record is used as read the nth 
time. The number of times a check is made is determined by Basic 
Monitor Parameters. 

UNIT XXXXX FILE XXXX REC. XXXX 25 ERASES DURING WRITE 

Twenty-five erasures have been made while attempting to write an 
output record. The program will continue to attempt writing. 

UNIT XXXXX FILE XXXX REC. XXXX NOISE RECORD DISCARDED 

A redundancy check has occurred on the first attempt to read a tape 
record of two or less words. The record is considered to be tape noise 
and is ignored. 

UNIT XXXXX FILE XXXX REC. XXXX SHORT RECORD WRITTEN 

A record of 1 or 2 words has been written. Note that if such a 
record is redundant when later read, it will be treated as a noise 
record. 

UNIT XXXXX FILE XXXX REC. XXXX NOISE ON ERASE 

An attempt to erase a section of tape on which a record could not be 
written has produced a redundancy check. 

UNIT XXXXX EOT ON ERASE 

CANNOT PROCEED 

End of tape encountered while trying to erase tape on which re- 
dundancy occurred. 

I/O CHECK 

PRESS START TO CONTINUE 

A machine error has probably occurred. When the Start key is de- 
pressed, the message condition ignored is printed. 

Configuration Error BASIC IOCS NECESSARY XXXXX 

Message or 

LABEL IOCS NECESSARY XXXXX 
CANNOT PROCEED 

The iocs configuration being used does not contain some routine 
required by the program, xxxxx is the octal location of the reference 
to the missing routine. 
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Section 3— Checkpoint and Restart Procedures 
Operator Initiated Checkpoints 



Restart Procedure 



iocs has provision for an operator to take a checkpoint if a checkpoint file has 
been assigned by the Preprocessor and the file has been opened by the program. 
This feature may be used to interrupt the execution of a program and to restart 
it at some later time. The procedure is as follows: 

1. Set the Checkpoint Control Sense Switch Down. 

2. The following message is printed: 

CHECKPOINT XXXXX CODE YYYYYY ZZZZZZ 

The checkpoint identification is xxxxx and the restart code for this check- 
point is yyyyyy zzzzzz. The physical tape address of the unit on which the 
checkpoint is taken is yyyyyy. 

3. Restore the Checkpoint Control Sense Switch. 



The following are operator procedures for restarting: 

1. Obtain the identification number (xxxxx) and restart code (yyyyyy zzzzzz) 

of the desired checkpoint record, which were printed at the time the check- 
point was taken. 

2. Mount the tape which contains the checkpoint record on the tape unit which 

is indicated by the left half of the restart code (yyyyyy) . 

3. Set the Restart Control Sense Switch Down, or use "RESTART Card. 

4. $EXECUTE IOCS via Rasic Monitor operation. 

5. After the message set keys to restart code is printed, a halt occurs. Enter 

the correct code (yyyyyy zzzzzz) in the panel entry keys and depress the 
Start key. 

6. The checkpoint identification is printed: restart xxxxx. Verify the identifi- 

cation number. 

7. The following message is printed: 

SET SENSE SWITCHES 1 j££| 2 {gj| 3 {££} 
A \UP\ K WP\ R WP\ 

4 \dn\ 5 \dn\ 6 \dn\ 

Set sense switches accordingly. 

8. A summary of tape usage is printed and a halt occurs again. This summary 

is similar to the File List printed at the beginning of a job. Mount tapes 
as indicated, and then depress the Start key. 



Messages During Restarting 



RESTART XXXXX 

SET SENSE SWITCHES 1XX 2XX 3XX 4XX 5XX 6XX 

(Restart message— any number of lines) 

OPERATOR ACTION PAUSE 
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The message indicates up or dn for each sense switch. After the sense 
switches have been set and all restart instructions have been followed, 
depress the Start key. The message action completed is then printed 
and the restart procedure continues. 

SET KEYS TO RESTART CODE 

OPERATOR ACTION PAUSE 

When the message is printed, the panel entry keys should be set to the 
restart code corresponding to the checkpoint record with which restart- 
ing is to begin (usually the last one written). The Start key should 
then be depressed. 



Restart Error Messages 



PERM. REDUN. ON CHECKPOINT MESSAGE BLOCK 

PRESS START TO CONTINUE 

Ten consecutive atempts have been made to read the checkpoint 
record. When the Start key is depressed, the message condition 
ignored is printed and the program continues. 

INCORRECT CHECKPOINT TAPE ADDRESS 
CANNOT PROCEED 

An illegal unit address for the checkpoint tape has been specified in 

the panel keys. 

UNIT XXXXX POSITIONING FAILED 
CANNOT PROCEED 

The restart program has been unable to properly position tape 

xxxxxx. 
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Appendix A: File Control Block Format 



The 12 words which make up a File Control Block are arranged as follows: 



Word S 1 2 3 



17 18 19 20 21 







■ 



Entry point for non-standard label 
image routines 



o o oi 

Up 



Block count for sequence 

check 



? o o og: 



Location of buffer pool 



Number of erases if output, or of 
permanent redundancies if read 



gooo| 




UCW1 
27 28 



Number of Buffers 



logical use 



Number of Buffers 
ahead 



Location of buffer in use; if none, 
location of buffer pool 



Location of group control word 
if reserve or internal file 



Sync chain, or request chain at 
end of tape condition 



Number of corrected redundancies 
on the current reel 



File Serial Number 



Reel Sequence Number 



Retention Days 



File Name {first six characters) 



File Name (second six characters) 



File Name {last six characters) 



The details of these twelve words are given below. Items marked with an aster- 
isk are generated in the File Control Block by the Preprocessor. The remaining 
positions are initially zero. 

Word(s) Bits Contents 

1 S* Mounting flag secondary unit (operator has been 

instructed to mount a reel on the secondary unit). 
1- 2 Unused. 

3-17* Unit Control Block for secondary unit. If no sec- 

ondary unit is used, this is the same as bits 21—35. 
18* Mounting flag, primary unit (operator has been 

instructed to mount a reel on the primary unit). 
19-20 Unused. 

21-35* Unit Control Block for primary unit. 

Note: 

If this is an Internal File, the first word is of the 
form: 

PZE CHAIN, ,0 
where 

CHAIN = L(0) if no chain exists. 
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Word(s) Bits Contents 

2 S* Mixed mode file: 

0-No 
1-Yes 

1- 2* Checkpoint control 

00 -No checkpoints initiated by this file. 

01 - Checkpoints are to be written on the 

checkpoint file at the beginning of every reel 

of this file. 
10 - Checkpoints are to be written on this file 

at the beginning of every reel of the file 

(labeled output files only). 

3 0-File is not open. 
1 - File is open. 

4 - Not a Reserve file. 
1 - Reserve file. 

5 - File is inhibited. 

1 - File is not inhibited. 
6* Mode: 

0-BCD 

I - Binary 
7- 8* File type: 

00 -Input file 

01 - Partial block output file 

10 - Total block output file 

II - Checkpoint file 
9* Label: 

0-No 

1-Yes 
10-11* Block sequence and check sums: 

00 - No block sequence words 

10 - Block sequence word is present, no check 
sums. 

11 -Block sequence word is present, check 
sums are present (input) or are to be com- 
puted (output). 

12* Reel control flag: 

- Single reel file, if unlabeled; no label search, 

if labeled 

1 - Multi-reel file, if unlabeled; search for label 

on open, if labeled 

13 Has a buffer been released: 

0-No 
1-Yes 

14 Has a rush occurred for this buffer: 

0-No 
1-Yes 
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Word(s) 


Bits 


Contents 




15 


End-of-tape: 
1-No 
0-Yes 




16 


File permanently closed: 
0-No 
1-Yes 




17 


Has a rush occurred in this sequence: 
0-No 
1-Yes 




18* 


Density of label to be read: 
0-Low 
1 - High 




19* 


Label density to be written: 
0-Low density 
1 - High density 




20* 


File density: 

0-Low density 
1-High density 




21^35 


Count of Read buffers, or Output file chain 
21-27 Number of buffers in logical use 
28-35 Number of buffers ahead 


3 


S 


Regenerative Internal file if S — 1 




1- 2 


Unused. 




3-17 


Location of entry point for standard or non-stand- 
ard label image routines. 




18-20 


Unused. 




21-35 


Location of the control word for the buffer or buffer 



pool to be used with this file. 

S* File control: 

- Regular file 

1 - Internal file 

1— 2 Unused. 

3-17 Counter for block sequence checking. 

18-20 Unused. 

21-35 Location of the Reserve Group control word, if this 

is a Reserve file. 

S* List control: 

- List this FILE card. 

1 - Do not list this FILE card. 

1- 2 Unused. 

3-17 Location of the Buffer Pool. 
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Word(s) 



Bits 



Contents 



5 


18-20 




21-35* 


6 


S, 1- 2 




3-17 




18-20 




21-35 


7 


All* 


8 


All* 


9 


All* 


10-12 


All* 



Unused. 



Buffer synchronization chain or location of zero cell 

(end of chain); 
Buffer request chain at end of tape condition. 

Unused. 

Count of erase areas on the current output reel, or 
of permanent redundancies on the current in- 
put reel. 

Unused. 

Number of corrected redundancies for the current 
reel. 

File serial number in the form bXXXXX. 
Reel sequence number in the form bXXXXb. 
Retention days: bbbXXX. 
File name in BCD. 
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Appendix B: Miscellaneous Programming Information 

Preservation of File Lists 

A program will normally retain a file list used to attach several files simultane- 
ously, since the same list can be referred to later when these files are closed. In 
addition, any file list which contains one or more Internal or Reserve Groups 
must be preserved, at least until all such groups in the list have been closed. 
This is necessary because iocs reflects the current status of a group by modifying 
the file and buffer counts which appear in the Group control word. 

File Position After File Closing 

When a file is closed, whether at the end of file position or not, it is always 
unbuffered, so that its physical position corresponds to the last logical usage of 
the file. Note, however, that in the case of an input file, information in a partially 
processed buffer may be lost if the file is closed and then reopened, because the 
tape will be positioned beyond the block which occupied this buffer. 



Backspace File 



When the subroutine bsf is used to backspace over one or more labeled files, 
the structure of such files must be kept clearly in mind. For example, after an 
eof exit has occurred for a labeled input file, use of bsf will produce the follow- 
ing results, depending on the count specified: 

Count Tape Position on Exit 

1 Beyond eof mark following the trailer label. 

2 In front of the trailer label record. 

3 In front of the first data block of the file. 

4 In front of the first header label for the file, if it is a single reel file; 

or in front of the label of the current reel of a multi-reel file with- 
out checkpoints; or in front of the checkpoint record of a multi- 
reel file with checkpoints. 

5 In front of the header label for the file, if a checkpoint was written on 

the file. 



Use of Copy When "Reading" with Transmitting Commands 



The copy routine is normally used to transfer information located by ioxyn com- 
mands. There are certain instances, however, in which words transmitted out of 
a buffer will also be included in a subsequent copy to an output file. These 
cases are: 

1. All those words in the same buffer in which one or more words were located, 
and which precede the last word "read," are copied. Any words beyond the 
last word "read" are not copied. For example, assume that the following 
sequence is used to "read" the first twelve words of a 20-word record: 

IOCP WS, , 3 

IOCTN **, , 9 
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If the file is now copied, the twelve words "read" will form a new 12-word 
record in the output file. Words 13-20 are lost from both files. 

2. Even if all of the words in a buffer are transmitted to working storage, the 
buffer is still connected to the file unless the last word was "read" with an 
iocd or iory command. The transmitted words can then be copied. For 
example, if the block is "read" by 

IOCT WS, , BLOCK-SIZE 

it may be copied. If, however, the block is "read" by 

IORT WS, , ** 

it cannot be copied, because the iort command has disconnected the buffer 
from the file. 



Re-use of a Buffer Pool 



Joining Pools 



When all of the files attached to a Buffer Pool have been closed, the structure of 
the pool is essentially the same as when it was first defined, and a new set of 
files may be attached to it. Note that any Reserve or Internal Groups must also 
have been closed by an appropriate reference in a close list. 



When one Buffer Pool is joined to another, it must have the exact form of a 
pool which has just been defined. Because any use of a pool will, in general, 
alter the order in which its buffers are chained, such a previously used pool must 
be redefined before it is joined to another. 



Actions of IOCS Routines Under Abnormal Conditions 

Routine Condition 



Action 



DEFINE Attempt to define a buffer pool inside 
the system boundaries 

JOIN pool2 in use ( or already joined to a dif- 

ferent pool) 

poolI joined to any buffer pool 

ATTACH Attempt to attach a closed file which 
has been rewound and unloaded 

Attempt to attach to pool in use 

Not enough buffers in a buffer pool 

CLOSE Close a closed file 



OPEN Attempt to open a file which was re- 

wound and unloaded 



Stop: Pool Error 
Stop: Pool Error 

Stop: Pool Error 

Stop: Initialization 
Error 

Not tested 

Stop: Attach Error 

nop, except that 
rewind option is used 

Stop: Initialization 
Error 
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Routine 



Condition 



Action 



READ File never opened 

File already closed 

Block sequence error 

Check sum error 

Redundancy error 

Sequence and redundancy errors 

Check sum and redundancy errors 

Attempt to locate information in two 
buffers with one command 

Attempt to locate in more buffers than 
are available 

Attempt to transmit a word into the sys- 
tem 

WRITE File never opened 

File already closed 
Attempt to locate information in two 

buffers with one command 
Attempt to locate in more buffers than 

are available 

COPY Either file not open 

No buffer(s) connected to the input file 
Files not on same pool 

REW File never opened 

File already closed 
File is labeled 

WEF File never opened 

File already closed 
File is input file 
File is labeled 

File never opened 

File already closed 

bsf one file after eof exit 

File never opened 
File already closed 
Following eof exit 

Tape positioned in front of the first rec- 
ord of a file 

STASH Either file not open 

Case 1: No buffer in fileI chain 
Case 2: file2 group full 
Case 4: file2 group full 



BSF 



BSR 



eof exit 
eof exit 
errob exit mq b - 2 = 1 

ERROR exit MQ B .j = 2 
ERROR exit MQ 8 _2 = 4 
ERROR exit MQg-a = 5 
ERROR exit MQg-z = 6 
EOB exit MQs^, = 2 

EOB exit MQg-2 = 4 

Stop: Illegal Transmit 

Normal exit 
Normal exit 

EOB exit MQs_2 = 2 
EOB exit MQs-2 = 4 

NOP 
NOP 

NOT TESTED 

NOP 

NOP 
NOP 

NOP 
NOP 
NOP 
NOP 

NOP 
NOP 
NOP 

NOP 
NOP 

bof exit 
bof exit 

NOP 

nts exit 
nts exit 
nts exit 
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IOCS Command Execution Tables 



The details of the execution of the iocs commands are presented in the two tables 
which follow. Each case described is presented in reference to the following 
diagram: 



Current Buffer 




B-* 



Processed words 



Available words 



PZE C, ,S 



IORT *i-l,,S 



Next Buffer (to be acquired) 



^Available words 



where 

B— the location in the current buffer of the first available word 
m— the number of available words in the current buffer 
C— the location of the first word in the next buffer 
s— the size of all buffers in the pool 

In the tables which follow, the general form of the iocs command executed is: 

IOXY A, , N 

or 
IOXYN **, , N 

where 

A— the location in working storage to be "read" into or "written" from 
N— the number of words to be processed 

Indirect addressing of commands is not shown, however, it may be specified 
for all iocs commands except tch. 

In the two tables there are several actions indicated for buffer release or trunca- 
tion, these are: 

Hold— the end of the buffer was passed, however, it will not be released to the 
pool (read) or written (white) until next reference to the file, because it 
contains words located by this bead or write sequence. 

Conditional Hold— the buffer will go into hold status if some ioxyn command 
were executed on it during the current read or write sequence. 



72 



Execution of IOCS Commands Read 



EOB = 



EOB + 



IOCS 
Command 



IOCY 


A,,n 




n-<m 




n> m 


IOCD 


A,,n 




n<m 
n > m 


IOSY 


A,,n 




n<m 




n > m 



IORY A , , * * 



IOCS 
Command 
changed to 



IORYA,,m 



History Record 
in AC 



PZE A + n , 
PZE A + n , 


,m — n 
, s — n + m 


PZE A + h , 
PZE A + n , 


,m — n 
,s — n + m 


PZE A + n , 
PZEA + m 


, m — n 
,0 



PZEA+m, ,0 



Words 
Read 



Buffer 

Re- 
leased 



n 
n 


no 
1st 


n 
n 


yes 
both 


n 
m 


no 
no 



yes 



IOCS 

Command 
changed to 


History Record 
in AC 


Words 

Read 


Buffer Release 
Action 


EOB 

exit 


PZE A + n , , m - n 
PZE A + n , , s - n + m 


n 
n 


no 
Conditional Hold 1st 


no 
no 


- 


PZE A + n , , m - n 
PZE A+n,,s-n+m 


n 
n 


Conditional Hold 
Conditional Hold both 


no 
no 


- 


PZE A + n , , m - n 
PZEA + m,,0 


n 

m 


no 

no 


no 
no 


IORY A , , m 


PZEA+m,,0 


m 


Conditional Hold 


no 



SKIP 



LOCATE 



IOCYN 


**,,n 
n<m 
n > m 


IOCDN 


n-<m 
n > m 


IOSYN 


**„n 
n-<m 

n >m 


IORYN 


* * * * 



IOCYN B , , n 
IOCYN C , , n 


PZE B + n , , m - n 
PZE C + n - m , , s - 


n + m 


n 
n 


no 
1st 


IOCDN B , , n 
IOCDN C , , n 


PZE B + n , , m - n 
PZE C + n - m , , s - 


-n + m 


n 
n 


yes 
both 


IOSYN B , , n 
IOSYN B , , n 


PZE B + n , , m - n 
PZE B + m , , 


n 

m 


no 
no 


IORYN B , , m 


PZE B + m , , 


m 


yes 



IOCYN B , , n 
IOCYN B , , n 


PZE B + n , , m - n 
PZE B + m , , 


n 
m 


no 
Hold 


no 
code 2 


IOCDN B , , n 
IOCDN B , , n 


PZE B + n , , m - n 
PZE B + m , , 


n 
m 


Hold 
Hold 


no 
code 2 


IOSYN B , , n 
IOSYN B , , n 


PZE B + n , , m - n 
PZE B + m , , 


n 

m 


no 

no 


no 
no 


IORYN B , , m 


PZE B + m , , 


m 


Hold 


no 



Execution of IOCS Command* Write 



IOCS 
Command 



IOCY 


A,,n 




n<m 




n> m 


IOCD 


A,,n 




n<m 




n>m 


IOSYN 


A,,n 




n-<m 




n> m 



IORY A , , n 
n<m 
n>m 



IOCS 
Command 
changed to 


History Record 
in AC 


Words 


Buffer 


written 


PZE A + n , , m — n 
PZE A + n , f s - m + n 


n 
n 


no 
1st 


- 


PZE A + n , , m - n 

PZE-A + n,,s- m +n 


n 
n 


yes 
all 


- 


PZE A + n , , m - n 
PZE A + n , , s - n 


n 
n 


no 
1st 


_ 


PZE A + n„m-n 
PZE A 4- m , , 


n 
m 


yes 
yes 



EOB + 



IOCS 
Command 

changed to 


History Record 
in AC 


Words 
"writ- 
ten" 


Buffer Release . 
Action 


EOB 
exit 


- 


PZE A + n , , m - n 
PZE A + n , , s - m + n 


n 
n 


no 
Conditional Hold 1st 


no 
no 

no 
no 


- 


PZE A + n , , m - n 
PZE A + n,,s-m + n 


n 
n 


Conditional Hold 
Conditional Hold both 


- 


PZE A + n , , m - n 

PZE A + n , , s - n 


n 
n 


no 
Conditional Hold 1st 


no 
no 


- 


PZE A + n , , m - n 
PZE A + m , , 


n 
m 


Conditional Hold 
Conditional Hold 


no 
no 



SKIP 



LOCATE 



IOCYN 


**,,!> 




n -cm 




n>m 


IOCDN 


**,,n 




n-<m 




n >m 


IOSYN 


* * ,,o 




n -<m 




n > m 


IORYN 


**.." 




n<m 




n>m 



IOCYN B , , n 
IOCYN C , , n 


PZE B + n , , m - n 
PZE C + n - m , , s - 


m + n 


n 
n 


no 
1st 


IOCDN B , , n 
IOCDN C , , n 


PZE B + n , , m - n 
PZE C + n - m , , s - 


m + n 


n 
n 


yes 
all 


IOSYN B , , n 
IOSYN C , , n 


PZE B + n , , m 
PZE C + n , , s 






no 
1st 


IORYN B , , n 
IORYN B , , n 


PZE B + n , , m - n 
PZE B + m , , 


n 
m 


yes 
yes 



IOCYN B , , n 
IOCYN B , , n 


PZEB + n,,m-n 
PZEB+m,,0 


n 
m 


no 
Hold 


no 
code 2 


IOCDN B , , n 
IOCDN B , , n 


PZE B + n , , m - n 
PZEB+m,,0 


n 
m 


Hold 
Hold 


no 
code 2 


IOSYN B , , n 
IOSYN C , , n 


PZE B + n , , m 
PZE C + n , , s 






no 
Conditional Hold 1st 


no 
no 


IORYN B , , n 
IORYN B , , n 


PZE B + n , , m - n 
PZEB + m,,0 


n 
m 


Hold 

Hold 


no 
no 
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Glossary 



The following glossary gives definitions of terms as used in this manual. The 
definitions do not necessarily apply to other systems. 



ATTACH 

AVAILABLE BUFFER 
AVAILABLE BUFFER COUNT 
AVAILABLE WORD LOCATOR 

AVAILABLE WORDS 



The iocs routine which establishes the connection between a group of files and the buffer pool 
which they use. Every file, except a checkpoint file, must be attached to some buffer pool. 

A buffer not presently in use nor reserved for later use. 

The number of currently available buffers in a pool, kept by iocs for each buffer pool. 

The first word of each buffer, to keep track of the location of the next available word and the 
number of available words remaining in the buffer. 

Those words in an input buffer which have not yet been "read," or, in an output buffer, 
which have not yet been filled with data. 



BASIC MONITOR 

BLOCK 
BLOCKING 
BLOCK COUNT 

BLOCK CHECK SUM 

BLOCK SEQUENCE NUMBER 

BLOCK SEQUENCE WORD 

BSF 

BSR 

BUFFER 

BUFFER CONTROL 

BUFFER POOL 

BUFFER SIZE 



An intersystem supervisor which facilitates the continuous operation of many individual 
systems. See the bulletin entitled: IBM 7090 Operating Systems: Basic Monitor (IBSYS). 

A physical record; that is, a tape record, a card, or a line of print. 

The arrangement of data into blocks whose size is convenient and efficient for processing. 

The number of blocks processed on the current reel of a file, kept in the corresponding File 
Control Block. 

An 18-bit folded check sum of the data words in a block, which appears in positions S-17 of 
the Block Sequence Word. 

The position of a data block among the other data blocks in the current reel of a file. This 
number is found in positions 21-35 of the Block Sequence Word. 

A word which can be appended to each block of a binary file in order to provide additional 
checking information. 

The iocs routine which backspaces a tape to the beginning of the first data block of some file 
on that reel. 

The iocs routine which backspaces one data block of a file. The routine will not backspace 
across an end-of-file mark. 

An area assigned for iocs to use as an intermediate storage area for data which are to be trans- 
mitted between storage and the input/output devices. 

The control used by a class of iocs commands which treat all, or the remainder, of a buffer 
as a data group. 

A group of equal sized buffers connected in such a way as to permit sharing of buffers among 
a group of files. 

The maximum number of data words which a buffer can hold. This restricts output blocks to 
that maximum length and determines the maximum number of words which can be read from 
an input block. 



CHECKPOINT 
CHECKPOINT FILE 

CLOSE 
CKPT 



A reference point at which tape positions, the status of machine registers and switches, and the 
contents of storage are recorded for the purpose of later restarting the program. 

A tape specified to receive checkpoints which are initiated by the operator, or the program, or 
by reel switching on other files. The checkpoint file should not be attached, but must be 
opened. It cannot be labeled. 

The iocs routine used to terminate file usage, prepare end of file trailer labels, and rewind the 
file. 

The iocs routine which prepares a checkpoint on the current checkpoint file. 
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COMMAND (IOCS) 

CONTROL CARDS 

CONNECTED BUFFER 
COPY 

COUNT CONTROL 

CREATION DATE 



Specified in the calling sequence to the read or write routines, it controls the "reading" or 
"writing" of data. The general form of an iocs command is ioxy(n) (*). 

A group of cards which are used by the Preprocessor to initialize a job run. The six types 
of control cards are job, file, date, restart, load, and ibsys. 

A buffer currendy in use by a file. 

The iocs routine which transfers data from an input file to an output file by connecting proc- 
essed input buffers to that output file. 

The control used by a class of iocs commands which "reads" or "writes" a specified number 
of words. 

The date a file was prepared. It is contained in the label of a labeled file. 



DATE 

DEFINE 
DISCONNECT (buffer) 



A Preprocessor control card which introduces the current date to be used in the writing and 
checking of labels. 

The iocs routine used to impose the structure of a buffer pool upon a specified area of storage. 
To release a processed buffer from a file. 



EOB (end of buffer) 



EOF (end of file) 



ERR (error exit) 



EOT (end of tape) 



A programmed switch, specified in the calling sequence to the read and write routines, 
which determines the system interpretation of non- transmitting iocs commands. Under certain 
circumstances it is used as an exit from those routines. 

An address, specified in the calling sequence to the read routine, which is used as an exit 
upon recognition of an end of file condition. 

An address, specified in the calling sequence of the read routine, which is used as an exit 
upon recognition of an uncorrectable redundancy, or a block sequence or check sum error. 

An address, specified in the calling sequence of the wef routine, which is used as an exit upon 
recognition of the end-of-tape condition. 



FILE 

FILE BLOCK 

FILE BLOCK ORIGIN 

FILE CARD 

FILE CONTROL BLOCK 

FILE LIST 

FILE SERIAL NUMBER 



A body of data, recorded on some external medium, which can be processed by the iocs 
routines. 

The area of storage which contains all the File Control Blocks for a program. 

The location of the first word of the File Block, specified as an octal number on the job card. 

A Preprocessor control card which describes a file to be processed by iocs. 

12 cells allocated for control information about a file iocs is to process. The File Control Block 
is prepared by the Preprocessor from the symbolic information on a file card. 

A list of the files to be attached to a buffer pool. 

The Tape Serial Number of the first reel of a labeled file. This number must always be 
specified for a labeled input file. 



HEADER LABEL 



A record at the beginning of a reel of tape which identifies the reel. 



IBSYS 
IMMEDIATE FILE 

INTERNAL FILE 



The symbolic name for the Basic Monitor. 

A file which is opened automatically by the attach routine. Immediate Files cannot be re- 
opened by the user after being closed. 

A file which is contained entirely within a chain of buffers in core storage. Such a file has no 
external i/o unit associated with it. 
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INTERNAL GROUP 

INTERNAL GROUP 
CONTROL WORD 



I/O UNIT 



A group of Internal files, preceded in a file list by an Internal Group control word. 

A word with prefix six which precedes a group of Internal files in a file list. It specifies the 
buffer requirements of the group, and the number of files in the group which can be in use 
simultaneously. 

Allowable units in iocs are any tape, card reader, punch, or printer attached to a data channel. 



JOB CARD 
JOIN 



A Preprocessor control card which identifies a job and specifies the File Block Origin and 
length of the File Block. 

The iocs routine which connects two separately defined buffer pools, forming a larger pool 
whose buffers are not necessarily contiguous. 



LABEL 

LABELED FILE 
LOCATE 

LOGICAL CHANNEL 

LOGICAL RECORD 



A record at the beginning (header label) or end (trailer label) of a reel of tape, which con- 
tains control information for that reel. 

A tape file, each reel of which begins with a header label and ends with a trailer label. 

In iocs, the process of determining the location of data in a buffer. Locating is accomplished 
by the use of ioxyn commands. 

A designation for the group of Unit Control Blocks for all i/o units assigned to a single data 
channel. 

Data which, as a group, has some logical significance to the user. 



MULTI-REEL FILE 



MWR 



A tape file which is contained in more than one reel, iocs can process labeled multi-reel files 
and unlabeled multi-reel files which contain only one EOF mark on each reel. 

The ioex routine which prints messages on the system printer. 



NON-TRANSMITTING 
COMMANDS 



Those iocs commands, of the form ioxyn, which provide the location of data within a buffer, 
rather than transmitting the data between buffers and working storage. 



OPEN 



The iocs routine which does the initialization necessary in order to "read" or "write" a file. 



PREPROCESSOR 



The part of iocs which creates the File Control Blocks required by a program and acts as 
the iocs monitor. 



READ 
RESERVE FILE 

RESERVE GROUP 



RESERVE GROUP 
CONTROL WORD 



RESTART 



The iocs routine which, by direction of iocs commands, "reads" input data from a file. 

A file which belongs to some Reserve Group. It may be opened and closed any number of times 
during the course of a program. 

A group of files (preceded in a File List by a Reserve Group control word) whose exact buffer 
requirement can be specified by the user. 

A word which precedes each group of Reserve Files in a File List. It specifies that group's 
buffer requirement and the number of files in the group which can be In use simultaneously. 

The restoration of the contents of storage, the status of switches and registers, and the position 
of tapes to the condition held at the time a checkpoint was taken, and continuing the program 
from there. 
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RETENTION DAYS 
REW 



The number of days a file is to be saved after its creation. 
The iocs routine which can be used to rewind an unlabeled file. 



SKIP 

SPECIAL COUNT CONTROL 

STASH 

TAPE SERIAL NUMBER 

TRAILER LABEL 

TRANSMIT 

TRUNCATE 



In iocs, the process of bypassing data words in a buffer while "reading" or "writing." 
Skipping is accomplished by use of the ioxyn commands. 

The control used by a class of iocs commands which process by count unless terminated by 
the end of buffer condition. These commands are of the form iosy(n). 

The iocs routine which transfers data from an Internal file to a regular file or vice versa, or 
between Internal files, by reconnecting buffers from one file to another. 

A number appearing in a tape label which identifies that reel of tape. It is usually the same as 
the external identification of the reel. 

A record at the end of each reel of a labeled file which indicates whether or not that reel is 
the last reel of the file. 

In iocs, the process by which ioxy commands move data between buffers and the user's 
working storage. 

To ignore any remaining words in a processed buffer and release it from a file; for an input 
file, the buffer is made available; for an output file, action is initiated to write the contents 
of the buffer on that file's i/o unit. 



UNBLOCKING 
UNBUFFERING 

UNIT CONTROL BLOCK 



The separation of blocked data into its data groups. 

The process of adjusting the physical position of a tape to correspond to its logical position. 
For an output file, all buffers in use are truncated, and a delay occurs until all writing ceases. 
For an input file, all buffers in use are returned to the pool, and the tape is positioned to a 
point following the block corresponding to the buffer which contained the last word "read." 

A group of four control words in ioex of Basic Monitor for each i/o unit on the machine. 



WEF 
WRITE 



The iocs routine which can be used to write an eof mark on an unlabeled output file. 
The iocs routine which, by direction of iocs commands, "writes" output data on a file. 
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CLOSE 18, 19, 31, 70, 75 
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command execution table 72 
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data file 3 

data transmission 2, 10, 18 
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conventions 21, 35 
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EOR label 23 
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examples 

transmitting commands 12 

non-transmitting commands 14 

Executor 42, 43 

false redundancy 17 
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block origin 39, 42, 43, 76 

closing 2 
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initialization 1 
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preservation of 69 
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FILE card 23, 35, 42, 43, 76 



79 



File Control Block .... 1, 3, 23, 27, 33, 38, 40, 41, 65, 76 

reserving space for 4 

folded check sum 33 

halts 

system 58 

header labels 21, 22, 24, 35, 76 

history record 14, 39 

hold 72 

IBSYS Card 42, 46 

ID Card 42,46 

IOEX 36, 38 

Immediate files 6, 8, 76 

buffer requirements 7 

closing 18 
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initialization , 1 

input buffers 

Immediate files 6 

Internal files 7 

Reserve files 7 

Input Control Sense Switch 55 

Input files 6, 44, 66 

Internal files 7, 30, 76 

attachment 7 

closing 31 

opening 30 

Internal Group 30, 31, 32, 69, 77 

control word 8, 32, 77 

IOCD 11, 70 

IOCDN 13 

IOCP 11 

IOCPN 13 

IOCS commands 2, 10, 11, 75 

( see also specific command ) 

IOCS operation 58 

IOCS routines 15 
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job name 39 
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label 77 
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Label Control Sense Switch 55 
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blank tapes 21 
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tape format 21 
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procedures 21 

routines 25 
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labels 21 

LOAD Card 42, 45 

locate 2, 77 
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channels 41, 43, 77 
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look-ahead bits 35 

messages 

file processing 61 
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Preprocessor 56, 57 

restart 63, 64 

tape mounting 59 

tape removal 59 

multi-file reels 26 

multi-reel unlabeled files 26 

MWR 36, 77 

nonstandard 

labeling routines 25 

labels 24 

nontransmitting commands 11, 13, 16, 28, 77 

examples 14 

NTS 18, 31, 32, 71 

on-line messages 36 

OPEN 9, 19, 30, 70, 77 

opening files 1, 6, 9, 23, 26, 30 

operator checkpoint 34, 63 

output 

buffers 6 

files 44, 66 

type-P 6, 44, 66 

type-T 6, 44, 66 

overlapping 2, 6 

parameters 36 

physical block 6, 16, 20 

physical block control 10 

physical files 20 

physical record 3 

Pool 

control word 4 

length 4 

sample 5 

Preprocessor 1, 38, 40, 77 

error messages 56, 57 

primary input/output unit 43, 65 

program 
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input unit 38, 46, 55 
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preparation 38 

programming using IOCS 3 

READ 2, 10, 13, 15, 16, 17, 24, 26, 28, 31, 71, 77 

"read" 2, 10, 11, 12, 13, 17, 18, 69, 70 

redundancy 

error 16, 17, 55 

error message 62 

reel switching 23, 24, 26 
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buffer requirements 7 

closing 18, 19 

opening 9 

Reserve Group 7, 13, 27, 28, 69, 77 

control word 8, 19, 69, 77 

reserving space for File Control Blocks 3 

RESTART Card 42, 45 

restart 34, 77 

code 63 

messages 63, 64 

Restart Control Sense Switch 55, 63 

retention days 22, 24, 77 

REW 20, 42, 71,77 

rewinding 24 

labeled files 20 

rewind options 9, 19 

sample 

Buffer Pool 5 

problem 47 

secondary input/output unit 43, 65 

sense printer 37 

sense switch assignments 55 

sequence 

error 16, 17 

numbering 22, 23, 33, 44, 66 

single reel unlabeled files 25 

skipping 13, 16, 77 



special count control 10, 12, 77 

special routines 36 

standard label formats 21 

start procedure 56 

STASH 18, 31, 42, 71, 78 

suppression of error history 55 

system 

date 39 

halts 58 

operation 56 

tape 38, 56 

tape 

mounting messages 59 

removal messages 59 

serial number 22, 78 

TCH 12 

terminating command list 16 

trailer labels 21, 23, 24, 78 

end of file 23 

end of reel 23 

transfer of information 17 

transfer points 38 

transmission 2, 10, 12, 18, 78 

transmitting commands 11, 16 

examples 13 

truncate 11, 14, 16, 19, 78 

type-P output files 6, 44 

type-T output files 6, 44 

unbuffering 20, 78 

Unit Control Blocks 41, 65, 78 

files 26 

file procedures 26 

using a file for input and output 27 

using more than one buffer for a file 28 

variable length records 53 

WEF 19, 42, 71, 78 

WRITE 2, 10, 13, 16, 17, 31, 71, 78 

"write" 2, 10, 11, 12, 17 
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